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IBM VM/SSPs 


CMS Command and Macro Reference 


Nse this publication as a reference manual; 


it contains all of the command formats, 
Syntax rules, and operand and option 
descriptions for CMS commands, subcommands, 
functions, and Macro instructions for 
general users. 

The IBM VM/SP: CMS User's Guide, 
SC19-6210, contains tutorial information 
and functional descriptions of CMS 
commands, as well as information oon using 


the editor, 
of CMS. 
contents 


EXEC, and debugging facilities 
You should be familiar with the 
of the WMN/SP CMS User's Guide 
before you attempt to use this reference 
manual. For most of the CMS commands 
described in this publication, you may find 
additional useful notes in the VM/SP CMS 
User's Guide. 


This publication has eight sections: 


"Section 1. Introduction and General 
Concepts" describes the components of the 
VM/SP system and tells you how to enter CMS 
commands. It lists the notational 
conventions used in this manual, so that 
you can interpret the command format 
descriptions in Section 2. Section 1 also 
contains information about the CMS command 


search order and a summary of all the CMS 
commands available under VM/SP, including 
those not for general users. 

"Section 2. CMS Commands" contains 
complete format descriptions, and operand 
and option lists, for the CMS commands 
available to general users. Each command 
description contains usage notes, and lists 
responses and error messages (with 
associated return codes) produced by the 
command. 


EDIT Subcommands and Macros" 
describes the subcommands and macros 
available in the environment of the CMS 
editor, which you can invoke using the EDIT 
conmand with the OLD option. Each 
subcommand description contains usage notes 
and summarizes the types of responses you 
might receive. Where applicable, 
additional information is provided for 
users of display terminals. 


"Section 3. 


"Section 4. DEBUG Subcommands" describes 
the subcommands available in the debug 
environment of CMS. Each subcommand 


description contains usage notes and, where 
applicable, lists the responses to the 
subcommand. 
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"Section 5. 


EXEC Control Statements" 
describes the control statements, special 
variables, and built-in functions you can 
use when you create EXEC procedures to 
execute in CMS. The control statement 
descriptions contain usage notes, where 
applicable. 

"Section 6. CMS Functions" describes 
functions that are available to the CMS 
user. 

"Section 7. CMS Macro Instructions" 


lists the formats and operands of the CMS 
assembler language macro instructions you 
can use when you write programs to execute 
in CMS. 


"Section 8. HELP Format Words" describes 
the formats, operands, and defaults of the 
HELP facility format words. HELP format 
words are used in HELP description files 
when the user wantS HELP to format output 
when the HELP file is processed. 
has three 


This publication also 


appendixes: 


“Appendix A: Reserved Filetype Defaults" 
lists the filetypes that are recognized by 
the CMS editor and indicates the default 
settings that the editor supplies for 
logical tabs, truncation, verification, 
logical record length, and so on. 


"Appendix Bs: VSE/VSAM Functions Not 
Supported in CMS" lists the restrictions on 
the use of access method services and VSAM 
in the CMS/DOS environment of CMS. 

"Appendix Ce OS/VS Access Method 
Services and VSAM Functions Not Supported 
in CMS" lists the restrictions for 0S 
programmers uSing access method services 
and VSAM in CMS. 


Terminology 
Some of the following convenience terms are 
used throughout this publication: 


the ters 
VM/SP program 


e Throughout this publication, 
"VM/SP" refers to the 
package when you use it in conjunction 
with VM/370 Release 6. The terms "Cp" 
and "CMS" refer to the VM/370 components 
enhanced by the functions included in 


the VWM/SP package. Any references to 
"RSCS" and "IPCS", unless otherwise 
noted, is to the VM/370 components 


unchanged by the VM/SP package. 
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When you install and use VM/SP in 
conjunction with the WM/370 Release 6 
System Control Program (SCP), it becomes 
a functional operating systen that 
provides extended features to the 
Control Program (CP) and Conversational 
Monitor System (CMS) components of 
VM/370 Release 6. VM/SP adds no 
additional functions to the Remote 
Spooling Communications Subsystem (RSCS) 
and the Interactive Problem Control 
System (IPCS) components of VM/370. 
However, you can appreciably expand the 
capabilities of these components in a 
VM/SP system by installing the RSCS 
Networking program product (5748-XP1) 
and the VM/IPCS Extension program 
product (5748-SA1). 


The term "CMS/DOS" refers to the 
functions of CMS that become available 
when you issue the command: 


set dos on 


CMS/DOS is a part of the normal CMS 
system, and isS not a separate systen. 
Users who do not use CMS/DOS are 


sometimes referred to as OS users, since 
they use the OS’ simulation functions of 
CMS. 


Unless otherwise noted, the term "VSE" 
refers to the combination of the DOS/VSE 
systen control program and the 
VSE/Advanced Functions program product. 
In certain cases, the term DOS is still 
used aS a generic term. For example, 
disk packs initialized for use with VSE 
or any predecessor DOS or DOS/VS system 
may be referred to as DOS disks. 


The DOS-like simulation environment 
provided under the CMS component of the 
VM/System Product, continues to be 
referred to as CMS/DOS. 

The tern "GAM/SP", Graphic Access 
Method/System Product, refers to IBM 


Program Product 5668-978. 


The term "CMS files" refers exclusively 
to files that are in the format used by 
CMS file system commands. VSAM and OS 
data sets and DOS files are hot 
compatible with the CMS file format, and 
Cannot be manipulated using CMS file 
system commands. 


terms "disk" and "virtual disk" 
are used interchangeably to indicate 
disks that are in your CMS virtual 
machine configuration. Where necessary, 
a distinction is nade between the 
CmMS-formatted disks and disks in OS or 
DOS format. 


e The 


The term "CMS console stack" refers to 
the combination of the frogram stack and 
the terminal input buffer. 
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The following terms in this publication 
refer to the indicated support devices: 


"2305" refers to IBM 2305 Fixed Head 
Storage, Models 1 and 2. 

4, 
"270x" refers to IBM 2701, 2702, and J 


2703 Transmission Control Units or the 
Integrated Communications Adapter (ICA) 
on the Systen/370 Model 135. 


"3270" refers to a series of display 
devices, namely, the IBM 3275, 3276, 
3277, 3278, and 3279 Display Stations. 


A specific device type is used only when 
a distinction is required between device 
types. 


Information about display terminal usage 
also applies to the IBM 3138, 3148, and 
3158 Display Consoles when used in 
display mode, unless otherwise noted. 


Any information pertaining to the IBM 
3284 or 3286 Printer also pertains to 
the IBM 3287, 3288, and 3289 printers, 
unless otherwise noted. 


"3330" refers to the IBM 3330 Disk 
Storage Models 1, 2, or 11; and the 3350 
Direct Access Storage operating in 
3330/3333 Model 1 or 3330/3333 Model 11 
compatibility mode. 


"3340" refers to the IBM 3340 Disk 
Storage, Models A2, Bl, and B2, and the 
3344 Direct Access Storage Model B2. 


"3350" refers to the IBM 3350 Direct 
Access Storage Models A2 and B2 in 
hative node. 

"3375" refers to the IBM 3375 Direct 
Access Storage Device. 

"3380" refers to the IBM 3380 Direct 
Access Storage Device. 

13704", "3705", or "3704/3705" refers to 
IBM 3704 and 3705 Communications 
Controllers. 


"3705" refers to the 3705 I and the 3705 
II unless otherwise noted. 


"2781" refers to the IBM 2741 
3767, unless otherwise specified. 


and the 


"3066" refers to the IBM 3066 System 

Console. 

"3800" refers to the IBM 3800 Printing 

Subsysten. 

For a glossary of VM/SP terms, see the 

Vittual Machine/System Product: Library 
uide and Master Index, GC19-6207. 


PREREQUISITE PUBLICATIONS 


In addition to the VM/SP CMS User's Guide, 
prerequisite information is contained in 
the following publications: 

e For information about the terminal that 
you are using, including procedures for 
gaining access to the VM/SP system and 
logging On, see the IBM Virtual 
Machine/System Product: Terwinal User's 
Guide, GC19-6206. 


e If you are using an IBM 3767 
Communications Terminal, the IBM 3767 
Operator's Guide, GA18-2000, is a 
prerequisite. 

e The CP commands that are available to 


you aS a general user are described in 
IBM Virtual Machine/System Product: CP 
Command Reference for General Users, 
SC19-6211. 


For additional tutorial information on 
using CMS, you may want to use CMS for 
Programmers —- A Primer, SR20-4438. 


If you are going to use an IBM Progranp 
Product compiler under CMS, you should have 
available the appropriate program product 
documentation. These publications are 
listed in IBM Virtual Machine/Systen 
Product: Introduction, GC19-6200. 


COREQUISITE PUBLICATIONS 


The IBM Virtual 
system Messages 


Machine/System Product: 
and Codes, SC 19-6204, 
describes allof the error messages and 
system responses produced by the CMS 
commands and EDIT and DEBUG subcommands 
referenced in this publication. It also 


lists the error messages issued by the EXEC 


processor during execution of your EXEC 
procedures. 
If you are alternating between CMS and 


other operating systems in virtual nachines 
running under VM/SP, you should consult IBM 
Virtual Sachine/System Product: Operating 
Systems in a Virtual Machine, GC19-6212. 


For information on the VM/SP Systen 
Product Editor refer to VM/SP System 


Product Editor Command and Macro Reference, 
SC24-5221 and VM/SP System Product Editor 
User's Guide, SC24-5220. 


For information on EXEC 2 refer to VWM/SP 
EXEC 2 Reference, SC24-5219. 


SUPPLEMENTAL PUBLICATIONS 


For general information about the VM/SP 
systen, see IBM Virtual Machine/Syster 
Product: Introduction, GC19-6200. 


Additional descriptions of various CMS 
functions and commands which are normally 
used by system support personnel are 
described in: 


IBM Virtual Machine/System Product: 
System Programmer's Guide, SC19-6203 


Operator Guide, SC19-6202 


fi 


Generation Guide, 


Information on IPCS commands, which are 
invoked under CSS, is contained in IBM 
Nirctual Machine Facility/370: Interactive 
Problea Control System (IPCS) User's Guide, 
GC20-1823. 


Details on the CMS CPEREP, a command 
used to generate output reports from VM/SP 
error recording records, are contained in: 


IBM Virtual Machine/System Product: OLISEP 
and Error Recording Guide, SC19-6205. 

For more details on the operands used 
with CPEREP, refer to: 
OS/VS, DOS/VSE, VA/370 Environmental 
Recording, Editing, and Printing (EREP) 


Program, GC28-0772. 


For messages issued by CMS CPEREP, see: 


OS/VS, DOS/VSE, VM/370 EREP Messages, 
GC38-1045. 


For information on IBM GAM/SP, refer to: 


OS/VS Graphic Programming Services (GPS) 
f£0r IBM 2250 pases ay Unit “and IBM 3250 


Graphics Display sys sten, ~§C27-6971 
CMS GAM/SP User's Guide, LC33-0126 


Details on the CMS I0OCP command are 


contained in: 


VM/SP and Stand-Alone Versions: 


Input/ou tput Configuration Program Guide 
and Reference, GC20-1840. 
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For VM/SP Users 


There are three publications available as 
ready reference material when you use VM/SP 
and CMS. They are: 


IBM Virtual Machine/System Product: 
S, SX20-4400 


ser), SX20-4401. 


Commands (other than General User), 

SX20-4402. 

If you are going to use the Renote 
Spooling Communications Subsystem, see the 
IBM Virtual Machine Facility/370: Remote 
Spooling Communications Subsystem (RSCS) 
User's Guide, GC20-1816. 

Assembler language programmers may find 
information about the VA4/SP assembler in 
OSZVS, DOS/VS, and VM/370 Assembler 
Language, Order No. GC33-4010, and OS/V¥S 
and VM/370 Assembler Programmer's Guide, 


GC 33-4021. 


For VSAM and Access 


of Access Method Services is 
based on VSE and VSE/VSAM. The control 
Statements that you can use are described 
in Using VSE/VSAM Commands and MSNacros, 
SC24-5144,. The VWM/SP: CMS User's Guide 
contains details on how to use this 
support. 


EIror messages produced by the 
Access Method Services 


program, and return 
codes and reason codes are listed in 


VSE/VSAM Messages and Codes, SC24-5146. 


CMS support 


For additional information refer to the 
VSE/VSAM Programmer's Reference, SC24-5145. 


viil 


For a detailed description 
macros and macro parameters, refer to the 
VSE/Advanced Functions Macro User's Guide, 
SC24-5210 and VSE/Advanced Functions Macro 
Reference, SC24-5211. For information on 
OS/VS VSAM macros, refer to OS/VS Virtual 


Storage Access Method (VSAM) Programmer's 
Guide, GC26-3818. 


of VSE/VSAM 


The CMS ESERV command invokes the VSE ESERV 
program, and uses, aS input, the control 
Statements that you would use in VSE. 
These control statements are described in 
Guide to the VSE Assembler, GC33-4024. 


Linkage editor control statements, used 


when invoking the linkage editor under 
CMS/DOS, are described in VSE System 
Control Statements, SC33-6095. 

Batch DL/I application programs can be 
written and tested in the CMS/DOS 
environment. See VM/SP CMS User's Guide, 
and DL/I DOS/VS General Information, 


GH20-1246, for details. 


For information on VSE and CMS/DOS tape 
label processing, refer to: VSE/Advanced 
Functions Tape Labels, SC24-5212. 
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VM/SP Licensed 
Program Spcifications 


GC20- 1842 (36) 


VM/SP Library Guide 
and Master Index 


GC19-6207 


VM/SP System Messages 
and Codes 


$C19-6204 (40) 


EREP Messages 
GC38 - 1045 


Auxiliary Support 


4 


VM/370 Remote Spooling 
Communications 
Susbsystem User's Guide 


GC20- 1816 (30) 


VM/370 System Logic and 
Problem Determination 
Guide Volume 3 (RSCS). 


SY20-0888 (36) 


VM/370 Interactive 
Problem Control System 
(IPCS) User’s Guide 


GC20- 1823 (37) 


Legend: 


Publications that support VM/SP as used 
in conjunction with VM/370 Release 6 


VM/SP General Information 
Manual 


GC20-1838 (00) 


VM/SP Introduction Note: The numbers given in 


GC19-6200 (20) parentheses represent 
the Subject Code. 
VM/SP Terminal User's 
Guide 
GC19-6206 (40) 
Operations 


” 


VM/SP CP Command ; ; 
Reference for General VM/SP Operator’s Guide 


Users - | §C19-6202 (40) 
$C19-6211 


CMS User 


VM/SP CMS Primer 
$C24-5236 (39) 


VM/SP CMS Command 
and Macro Reference 


$C19-6209 (39) 


VM/SP CMS User's Guide 
$C19-6210 (39) 


OS/VS and VM/370 
Assembler Programmer's 
Guide 


GC33-4021 (21) 


OS/VS, DOS/VS, VM/370 
Assembler Language 


GC33-4010 (21) 


VM/SP System Product 
Editor User’s Guide 


$C24-5220 (39) 


VM/SP System Product 
Editor Command and 
Macro Reference 


$C24-5221 (39) 


VM/SP EXEC 2 Reference 


$C24-5219 (36) 


System 
Programming 


VM/SP Planning and 
System Generation Guide 


$C19~-6201 (34) 


VM/SP Operating Systems 
ina Virtual Machine 


GC19-6212 (34) 


VM/SP System 
Programmer's Guide 


$C19-6203 (36) 


VM/SP Quick Guide for 
Users 


$X20-4400 (36) 


VM/SP Commands 
(General User) 


SX20-4401 


VM/SP Commands 
(Other than General Usa) 


$X20-4402 (36) 


VM/SP SP Editor 
Command Language 
Reference Summary 


$X24-5122 (36) 


VM/SP EXEC 2 Language 
Reference Summary 


SX24-5124 (36) 


rs 


1 | For SNA terminal users, the prerequisite publication is: VM/VCNA Installtion, Operations, and Terminal Use, Order Number SC27 -0502. 


All users of virtual machine must use the VM/SP System Messages and Codes publication. 


Contains information on VM/EREP support. EREP Release 3 is recommended for use with VM/SP Release 2. 


EJ VM/370 Release 6 components. However, the IPCS Extension Program Product (5748-SA1) and the RSCS Networking Program Product (5748-XP1) 


are recommended for usa with VM/SP. 


If you want all three of the Reference Summary publications, use SBOF 3820 when ordering. 
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Section 1. Introduction and General Concepts 


Virtual Machine/System Product (VM/SP) is a program product that, when 
used in conjunction with V4/370 Release 6, controls "virtual machines." 
A virtual machine is the functional equivalent of a real machine. 
However, where the real machine has lights to show status, and buttons 
and switches on the real system console to control it, the virtual 
machine does not. It has a virtual system console to display status and 
a command language to start operations and control then. The virtual 
system console is your terminal. 


VM/SP has two command languages, which correspond to the _ two 
components of the VM/SP systen: 


e The Control Program (CP) controls the resources of the real machine; 
that is, it controls the physical machine in your computer room. The 
CP commands are described in VM/SP CP Command Reference for General 
Users. 


e The Conversational Monitor System (CMS) is a conversational operating 
System designed to run under CP. This publication describes general 
use CMS commands, and the subcommands and macros that you can use in 
the CMS environment. 


When used in conjunction with VM/370 Release 6, the V4/370 components 
RSCS and IPCS are also available to the VM/SP user. 


e The Remote Spooling Communications Subsystem (RSCS) is a subsystem 
designed to supervise transmission of files across a teleprocessing 
network controlled by CP. For information about RSCS, see the VM/370 
Remote Spooling Communications Subsystem (RSCS) User's Guide. 


e The Interactive Problem Control System (IPCS) provides’ systen 
programmers and installation support personnel with problem analysis 
and management facilities, including problem report creation, problem 
tracking, and CP abend dump analysis. IPCS runs in the CMS command 
environment; for details, see VM/370 IPCS User's Guide. 


Note: In the VM/SP environment, do not use the IPCS component of 
VM/370 for: (1) analysis, formatting, and printing of CP dumps taken 
in MP mode, and (2) analysis of CP dumps with an abend code added 
Since VM/370 Release 6. Note also that IPCS formats control blocks 
in VM/370 Release 6 format, except RECELOK which is not formatted at 
all. If a block has keen extended since VM/370 Release 6, IPCS does 
not format the extension. 


Except for IPCS, each of the above components has a unique "command 
environment" that must be active in order for a command to be accepted. 
For CMS users, the two basic command environments are the CP conmand 
environment and the CMS command environment. By default, CP commands are 
acceptable input in the CMS command environment; if you enter a CP 
command, CP executes it, but control returns to the CMS environment. 


The CMS Environment 


The CMS command language allows you to create, modify, debug, and, in 
general, Banipulate a system of files. 
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The OS/VS Assembler and many OS/VS and VSE (DOS) language processors 
can be executed under CMS. For example, the OS/VS BASIC, FORTRAN IV 
(G1), COBOL and PL/I compilers, as well as the DOS PL/I and DOS/VS COBOL 


compilers, can execute under CMS. You can find a complete list of 
language processors that can be executed under CMS in the VM/SP 
Introduction. CMS invokes the assembler andthe compilers when you 


issue the appropriate CMS commands. The ASSEMBLE command is described 
in this manual; the supported compiler commands are described in the 
appropriate program product publications. 


CMS commands allow you to read cards from a virtual card reader, 
punch cards to a virtual card punch, and print records on a virtual 
printer. Many commands are provided tc help you manipulate your virtual 
disks and files. The CMS commands are described in "Section 2. CMS 
Commands." 


A special set of CMS commands becomes available to you when you issue 
the command: 


set dos on 


These commands, called CMS/DOS commands, Simulate various functions of 
the VSE Operating System (DOS) in your CMS virtual machine. When the 
CMS/DOS environment is active, the CMS/DOS commands are an integral part 
of the CMS command language; they are listed alphabetically among the 
other CMS commands in "Section 2. CMS Commands." 


The EDIT command places your virtual Machine in the EDIT 
compatibility mode. In EDIT compatibility mode, you can issue both EDIT 
and XEDIT subcomnmands. In this environment you can use the editors to 
create and modify files. In the subcommand environment, you can place 
your virtual machine in either of two modes, edit mode or input mode. 
Edit mode lets you modify a file; input mode lets you create or add to a 
file. The subcommands available _ to you in the EDIT subcommand 
environment are described in "Section 3. EDIT Subcommands and Macros." 
For more information on XEDIT subcommands, see VM/SP: System Product 
Editor Command and Macro Reference. 


The DEBUG command places your virtual machine in the DEBUG subcommand 
environment. In this environment ycu can issue commands to display 
registers and storage, specify breakpoints (address instruction stops), 
display the contents of control words, and so on. The DEBUG subcommands 
are described in "Section 4. DEBUG Sukcommands." 


The EXEC command executes CMS command procedures, called EXEC files. 
You can create EXEC files consisting of CMS and CP commands and EXEC 
control statements. The EXEC facility also has a symbolic capability; by 
manipulating variable symbols within an EXEC file, you can control the 
execution of the procedure. These frocedures are usually created in the 


edit environment. The EXEC control statements, variable symbols, and 
built-in functions are described in "Section 5. EXEC Control 
Statements." 


You can use the CMS assembler language macros when you write 
assembler language programs to execute in the CMS environment. 
Descriptions of these macros are contained in "Section 7. CMS Macro 
Instructions." 


The HELP format words are used to create HELP 'text' information for 
user-defined commands, EXECs, and messages. The function, formats, and 
operands of the HELP facility format words are described in "Section 8. 
HELP Format Words." 
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Entering CMS Commands 


A CMS command consists of a command name, usually followed by one or 
more positional operands and, in many cases, by an option list. CMS 
commands and EDIT and DEBUG subcommands described in this publication 
are shown in the format: 


ee a I ee ee ear ee Seek eee ee Oe ee oe ae ee ge ee ee ee 
| command name | [operands...] [ (oftions...[) ]] l 
in i a a a a a i a etn iil ng i ace aS 


You must use one or more Elanks tc separate each entry in the command 
line unless otherwise indicated. For an explanation of the special 
symbols’ used to describe the conmand Syntax, see "Notational 
Conventions." 


The Command Name 


The command name is an alfhameric symbol of one to eight characters. In 
general, the names are based on verbs that describe the function you 
want the system to perform. For example, you may want to find out 
information concerning your GMS files. In this case, you would use the 
LISTFILE command. 


ommand Operands 


The command operands are keywords and/or positional operands of one to 
eight, and in a few cases, one to seven alphameric characters each. The 
operands specify the information on which the system operates when it 
performs the command function. 


You must write the operands in the order in which they appear in the 
command formats in "Section 2. CMS Commands," unless otherwise 
specified. When you are using CMS, blanks may optionally be used to 
separate the last operand from the oftion list. CMS recognizes a left 
parenthesis "(" as the beginning of an option list; it does not have to 
be preceded by a blank. 


The Command Options 


The command options are keywords used to control the execution of the 
command. The command formats in "Section 2. CMS Commands" show all the 
options for each CMS command. 


The option list must be preceded by a left parenthesis; the closing 
parenthesis is not necessary. 


For most commands, if conflicting or duplicate options are entered, 


the last option entered is the option in effect for the command. 
Exceptions to this rule are noted where applicable. 
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Comments in CMS Command Lines 


If you want to write comments with CMS commands, you enter then 
following the closing farenthesis of the option list. The only 
exception to this rule is the ERASE command, for which comments are not 
allowed. 


You can also enter comments on your console by using the CP #* 
command. 


Character Set Usage 


CMS commands may be entered using a combination of characters from six 
different character sets. The contents of each of the character sets is 
shown in Figure 2. 


| Character Set | Names | Symbols | 
| ( 
| Separator | Blank | | 
l ; | l 
| National | Dollar Sign =| $ l 
l {| Pound Sign { # | 
| | At Sign [ @ | 
; ; l 
| Alphabetic | Uppercase | A- Z | 
| {| Lowercase | a- z | 
| l ( | 
| Numeric | Numeric | Q-—- 9 | 
( ; ; | 
| Alphameric | National I $, #, @ | 
| | Alphabetic | A- Z | 
| | i a- Zz | 
| | Numeric | 0O-—- 9 | 
| { H l 
| Special | | All other | 
| [ | characters | 


| SS eee a ee Te ee 
Figure 2. Character Sets and Their Contents 


Notational Conventions 


The notation used to define the command syntax in this publication is: 

e Truncations and Abbreviations of Commands 
Where truncation of a command name is permitted, the shortest 
acceptable version of the command is represented by uppercase 
letters. (Remember, however, that CMS commands can be entered with 
any combination of uppercase and lowercase letters.) The following 
example shows the format specification for the FILEDEF command. 

FIlledef 


This format means that FI, FIL, FILE, FILED, FILEDE, and FILEDEF are 
all valid specifications for this ccmmand name. 
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Operands and options are specified in the same manner. Where 
truncation is permitted, the shortest acceptable version of the 
operand or option is represented by uppercase letters in the command 
format box. If no minimum truncation is noted, the entire word 
(represented by all uppercase letters) must be entered. 


Abbreviations are shorter forms of command operands and options. 
Abbreviations for operands and options are shown in the description 
of the individual operands and cptions that follow the format box. 
For example, the abbreviation for MEMBER in the PRINT command is HEM. 
Only these two forms are valid and no truncations are allowed. The 
format box contains 


MEMBER | ae 
* 


and the description that follows the format box is 


MEMBER \ name 
MEM * 


The following symbols are used to define the command format and 
should never be typed when the actual command is entered. 


underscore 

braces { 
brackets [ 
ellipsis : 


* wy” 


Uppercase letters and words, andthe following symbols, should be 
entered as specified in the format box. 


asterisk * 
comma ’ 
hyphen = 
equal sign = 
parentheses ( ) 
period P 
colon ; 


The abbreviations "fn", "ft", and "fm" refer to filename, filetype, 
and filemode, respectively. The combination "fn ft [fm]" is aiso 
called the file identifier or fileid. 


When a command format box shows the characters, fn ft fm or fileid 
and they are not enclosed by brackets or braces, it indicates that a 
CMS file identifier must be entered. If an asterisk (*) appears 
beneath fn, ft, or fm, it indicates that an asterisk may be coded in 
that position of the fileid. The operand description describes the 
usage of the *. 


Lowercase letters, words, and symbols that appear in the command 
format box represent variables for which specific information should 
be substituted. For example, "fn ft fm" indicates that file 
identifiers such as "MYFILE EXEC A1" should be entered. 


Choices are represented in the command format boxes by stacking. 
A 


B 
Cc 
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An underscore indicates an assumed default option. If an underscored 
choice is selected, it need not be specified when the command is 
entered. 


Example 
The representation 


OQ itd 


indicates that either A, B, or C may be selected. However, if B is 
selected, it need not be specified. Or, if none is entered, B is 
assumed. 


The use of braces denotes choices, one of which must be selected. 


Example 
The representation 


indicates that you pust specify either A, or B, or C. If a list of 
choices is enclosed by neither brackets or braces, it is to be 
treated as if enclosed by braces. 


The use of brackets denotes choices, one of which may be selected. 


Example: 
The representation 


P= oe |) 
OQ) to > 
| 


indicates that you may enter A, B, or C, or you may omit the field. 


In instances where there are nested braces or brackets on the text 
lines, the following rule applies: nested operand selection is 
dependent upon the selection of the operand of a higher level of 
nesting.’ 


Example: 


Level 1 Level 2 Level 3 
{filename [ filetype [filemode ]]] 


where the highest level of nesting is the operand that is enclosed in 
only one pair of brackets and the lowest level of nesting is the 
operand that is enclosed by the maximum number of brackets. Thus, in 
the previous example, the user has the option of selecting a file by 
filename only or filename filetype only or by filename filetype 
filemode. The user cannot select filetype alone because filetype is 
nested within filename and our rule states: the higher level of 
nesting must be selected in order to select the next level (lower 
level) operand. The same is true if the user wants to. select 
filemode; filename and filetype must also be selected. 
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=—e eee OE ee ee ee 


e An ellipsis indicates that the preceding item or group of items may 
be repeated more than once in succession. 


Example 
The representation 


(options...) 


indicates that more than one option may be coded within the 
parentheses. 


CMS Command Search Order 


When you enter a command line in the CMS environment, CMS has to locate 
the command to execute. If you have EXEC or MODULE files on any of your 
accessed disks, CMS treats them as commands; also, they are known as 
user-written commands. 


AS soon as the command name is found, the search stops and the 
command is executed. The search order is: 


1. Search for a file with filetype EXEC on any currently accessed 
disk. CMS uses the standard search order (A through Z.) 


2. Search for a valid name on any currently accessed disk, according 
to current SYNONYM file definitions in effect. 


3. Search for a nucleus extension command if the high order byte of 
register 1 is not equal to X'03' or X*'O4*,. 


4. Search for a command in the transient area. Commands which may be 
in the transient area are: 


ACCESS HELP READCARD 
ASSGN LISTFILE RELEASE 
COMPARE MODMAP RENAME 
DISK OPTION SET 

DLBL PRINT SVCTRACE 
FILEDEF PUNCH SYNONYM 
GENDIRT QUERY TAPE 
GLOBAL RDR TYPE 
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5. Search for a nucleus-resident command. The nucleus-resident CMS 
commands are: 


CP GENMOD NAMEFIND 
DEBUG INCLUDE START 
ERASE LOAD STATE 
EXECIO LOADMOD STATER 
FETCH 


6. Search for a file with filetype MODULE on any currently accessed 
disk 


7. Search for a valid abbreviation or truncation of a nucleus 
extension. 


8. Search for a valid abbreviation or truncation of a command in the 
transient area. 


9. Search for a valid abbreviation or truncation of a command in the 
nucleus. 


10. Search for a valid abbreviation or truncation of any other CMS 
command 


11. Search for a CP command. 
12. Search for a valid abbreviation or truncation of a CP ccmmand. 


For example, if you create a command module that has the same name as 
a CMS nucleus-resident command, your command module cannot be executed, 
Since CMS locates the nucleus-resident command first, and executes it. 
When a user-written command has the same name as a CMS command nodule 
abbreviation, certain error messages may indicate the CMS command nane, 
rather than the program name. 


Figure 3 shows a basic description of the command search order; you 
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NUCLEUS 
EXTENSION, 
TRANSIENT, 
OR 
NUCLEUS 
RESIDENT 
COMMAND 


dd 


: CMS 
MODULE 
SEARCH 


SEARCH 


Figure 3. How 


KEY INA 
COMMAND NAME 


EXECUTE 
THE FILE 
AND RETURN 
CONTROL TO 
CMS. 


EXPAND THE 
NAME TO THE 
FULL REAL 
NAME, EXECUTE 
IT, AND RETURN 
CONTROL TO CMS. 


YES EXECUTE THE 
NUCLEUS EXTENSION 


IS THE NAME 
A NUCLEUS EXTENSION 
COMMAND? 


AND RETURN CONTROL 
TO CMS. 


IS THE NAME 
A COMMAND THAT IS 
ALREADY IN THE 
TRANSIENT 


YES EXECUTE THE 
FILE AND 
RETURN CONTROL 
TO CMS. 


IS THE NAME 
A NUCLEUS RESIDENT 
COMMAND? 


YES EXECUTE THE MODULE 
AND RETURN CONTROL 
TO CMS. 


EXECUTE THE FILE 
AND RETURN CONTROL 
TO CMS. 


IS THE NAME 
A MODULE FILE? 


EXPAND THE NAME 
TO THE FULL REAL 
NAME, EXECUTE IT, 
AND RETURN 

CONTROL TO CMS. 


EXPAND THE 
NAME TO THE FULL 
REAL NAME, EXECUTE 
IT, AND RETURN 
CONTROL TO CMS. 


YES EXECUTE THE COMMAND 


IS THE NAME A AND RETURN CONTROL 


CP COMMAND? 


TO CMS. 


ISSUE 
AN ERROR 
MESSAGE 


CMS Searches for the Command to Execute 
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CMS Command Summary 


Figures 4 and 5 contain alphabetical lists of the CMS commands and the 
functions each performs. Figure 4 lists those commands that are 
available for general use; Figure 5 lists the commands used by systen 
programmers and system support personnel who are responsible for 
generating, maintaining, and ufdating VM/SP. Unless otherwise noted, 
CMS commands are described in this manual. For those commands not 
described in this manual, the "Code" column indicates the publication 
that describes the command: 


Code Meaning 
VSE PP indicates that this command invokes a VSE Program Product, 


available from IBM for a license fee. 


EREP indicates that this command is described in the VM/SP OLTSEP 
and Error Recording Guide; further details on the operands 
used by this command are contained in the OS/VS, DOS/VSE, 
VM/SP Environmental Recording, Editing, and Printing (EREP) 
Progran. 


IPCS indicates that this command isa part of the Interactive 
Problem Control System (IPCS), and is invoked under CMS. It 


Op Gd indicates that this command is described in the VM/SP 


OS PP indicates that this command invokes an OS Program Product, 
available from IBM for a license fee. 


SCRIPT indicates that this command invokes a text processor that is 
an IBM Installed User Program, available from IBM for a 
license fee. 


SPG indicates that this command is described in the VM/SP System 
Programmer's Guide. 


SYSGEN indicates that this ccmmand is described in the VM/SP Planning 
and System Generation Guide. 


IOCP UG indicates that this command is described in the VM/SP and 
Stand-Alone Versions: Input/Output Configuration Program 
User's Guide and Reference. 


Note: If a CMS command is described in this manual, but is also repeated 
in other VM/SP publications, the chart does not refer to those other 
publications. 


You can enter CMS commands when you are running CMS in your virtual 
machine, the terminal is idle, and the virtual machine can accept input. 
However, if CMS is processing a previously entered command and your 
typewriter terminal keyboard is locked, you must signal your virtual 
machine via an attention interruption. The system acknowledges the 
interruption by unlocking the keyboard. Now you can enter commands. 


If your terminal is a display device, there is no problem of entering 
commands while the virtual machine is busy because its keyboard remains 
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unlocked for additional command input. Note that in these circumstances 
the command you enter is stacked in the terminal input buffer and is not 
executed until the command that is currently being executed completes. 
If more commands are entered than CP can handle, a NOT ACCEPTED message 
is displayed at the display terminal. 


In addition to the commands listed in Figures 4 and 5, there are 
seven commands called Immediate commands that are handled in a different 
Manner from the others. They may be entered while another command is 
being executed by pressing the Attention key (or its eguivalent), and 
they are executed immediately. The Immediate commands are: 


HB - Halt batch execution 
HO —- Halt tracing 

HT -— Halt typing 

HX - Halt execution 

RO - ReSume tracing 

RT — Resume typing 

SO - Suspend tracing 
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| Command | Code | Usage 

l 

JACCESS | 

| | 

| i |space to a logical directory. 
| | | 

| AMSERV 

[ | 

l | |export VSAM catalogs and data sets. 
[ | | 

|ASSEMBLE | 

| [ | 

| ASSGN 

{ | 

| ; | 

|CHDCALL | 

I | |CMS extended plist command calls. 
| I | 

|CMSBATCH | [Invoke the CMS katch facility. 
; | | 

| COBOL |OS PP 

[ i | code. 

| | i 

| COMPARE | |Compare records in CMS disk files. 
| [ | 

| CONVERT |OS PP 

| | | 

[|COPYFILE | 

| | | 

[CP l 

| | | 

| CPEREP | EREP 

| | | 

| DDR [ 

[ | | disks. 

| [ | 

| DEBUG | [Enter CEBUG subcommand environment. 
( | i 

[DEFAULTS | 

| | 

| | | 

| DISK 

| | |for CMS files. 

| | | 

| DLBL | 

| | [that name to a disk file. 

| | | 

{| DOSLIB | 

| | |phases of a CMS/DCS phase library. 
i [ | 

| DOSLKED | 

| | 

| | 

| | | 

[|DOSPLI |VSE PP 

| ; | 

| DROPBUF | [Eliminate a program stack buffer. 
| ; | 

|DSERV | 

| | 

| | 


Figure 4. 


[Identify direct access space to a CMS virtual 
|machine, create extensions and relate the disk 


[Invoke access method services utility functions to 
|create, alter, list, copy, delete, import, or 
|Assemble assembler language source code. 


|Assign or unassign a CMS/DOS system or programmer 
J|logical unit for a virtual I/O device. 


[Converts EXEC 2 extended plist function calls to 


|}Compile OS ANS Version 4 or OS/VS COBOL source 


|Convert free form FORTRAN statements to fixed forn. 
|Copy CMS disk files according to specifications. 
[Enter CP commands from the CMS environment. 

[Format and edit system error records for output. 


|Perform backup, restore, and copy operations for 


|Set or display default options for the commands: 
| FILELIST, NOTE, RDRLIST, RECEIVE, PEEK and SENDFILE 


|Perform disk—to—card and card—to-—disk operations 
|Define a VSE filename or VSAM ddname and relate 
| Delete, compact, or list information about the 


| Link—edit CMS text decks or object modules from a 
|VSE relocatable library and place them in 
Jexecutable form in a CMS/DOS phase library. 


|Compile DOS PL/I source code under CMS/DOS. 


[Display information contained in the VSE core 
|image, relocatatle, source, procedure, and 
[transient directories. 
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ee ee eee 7 
|Command | Code | Usage { 
|——__—_—________---- | 
|EDIT | |Invoke the VM/SP System Product editor in CMS 
| [ Jeditor (EDIT) compatibility mode to create or 
| i |modify a disk file. | 
; | | 
| ERASE | {Delete CMS disk files. | 
| | | | 
[| ESERV | |Display, punch cr print an edited (compressed) | 
{ | [macro from a VSE source statement library 
[ | | (E sublikrary). ; 
| | 

| EXEC [ |Execute special procedures made up of frequently | 
| | [used sequences of commands. | 
| H | 
| EXECIO [ |Do I/O operations between a device and the progran | 
[ [ |stack. l 
| | | | 
| FCOBOL |VSE PP |Compile DOS/VS COBOL source code under CMS/DOS. | 
| | | | 
| FETCH { |Fetch a CMS/DOS or VSE executable phase. | 
| | | l 
| FILEDEF | |Define an OS ddname and relate that ddname to any | 
[ [ |device supported by CMS. | 
| ; | | 
|FILELIST | {List information about CMS disk files, with the | 
| { Jability to edit and issue commands from the list. | 
| | | | 
|FINIS [ |Close an open file. [ 
| l | | 
| FORMAT | |Prepare disks in CMS fixed block format. | 
| | ( 
| FORTGI {OS PP |Compile FORTRAN source code using the G1 compiler. | 
| | | ( 
| FORTHX |OS PP |Compile FORTRAN source code using the H-—extended | 
t | | compiler. | 
| | | 
|GENDIRT | [Fill in auxiliary module directories. | 
l | | l 
|GENMOD | |Generate nonrelocatable CMS files (MODULE files). | 
| l | l 
{GLOBAL | {Identify specific CMS libraries to be searched for | 
A [ {macros, copy files, missing subroutines, LOADLIB | 
| [ |modules, or DOS executable phases. | 
| | 1 | 
|GLOBALV | {|Set, Maintain, and retrieve a collection of named | 
[ | | variables. 
| | | | 
|GOFORT [OS PP |Compile FORTRAN source code and execute the progran| 
| | Jusing the FORTRAN Code and Go compiler. | 
l | | | 
| HELP | |Display information about CP, CMS, or user { 
| | |commands, EDIT, XEDIT, or DEBUG subcommands, EXEC | 
| | Jand EXEC2 control statements, and descriptions of | 
| [ {CMS and CP messages. [ 
| | | | 
[IDENTIFY | [Display or stack userid, nodeid, rscsid, date, | 
[ [ {|time, time zone, and day of the week. i 
| | | | 
| INCLUDE {Bring additional TEXT files into storage and 
| | Jestablish linkages. | 
| Esc es | 


Figure 4. CMS Command Summary (Part 2 of 5) 
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|Command 
; 
J IOCP 


LABELDEF 


LISTDS 


LISTFILE 


LISTIO 


te 
A 
te 
oO 


LOAD 


| LOADLIB 
ea0ueE 
cia 
er 


| 
| MODMAP 


| 
|MOVEFILE 
| 


| NAMEFIND 


| NAMES 


NOTE 


NUCXD ROP 
NUCXLOAD 
NUCXMAP 


OPTION 
OSRUN 


PEEK 


[ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
[| 
| 
| 
| 
| 
| 
| 
| PLIC 
| 


[Code [ Usage 
IOCP UG|Invoke the InputyCutput Configuration Program 
| 
[Specify standard HDR1 and EOF1 tape label descrip— 
[tion information for CMS, CMS/DOS, and OS 
[|simnulation. 
| 
[List information about data sets and space 
Jallocation on OS, DOS, and VSAM disks. 
| 
[List information about CMS disk files. 
| 
[Display informaticn concerning CMS/DOS system and 
| programmer logical units. 
| 
[Link edit a CMS TEXT file or OS object module into 
ja CMS LCADLIE. 
| 
|Bring TEXT files into storage for execution. 
| 
|Maintain CMS LOADLIB libraries. 
I 
|Bring a single MODULE file into storage. 
; 
|Create or modify CMS macro libraries. 
| 
|Create a new frogram stack buffer. 
| 
[Display the load map of a MODULE file. 
| 
|Move data from one device to another device of the 
|same or a different type. 
[Displayystack information from a NAMES file. 
| (default ‘userid NAMES'). 
| 
|Display a menu to create, display or modify entries 
jin a ‘userid NAMES! file. (The menu is available 
[only on display terminals.) 
| 
}Prepare a ‘note for one or more computer users, 
j|to be sent via the SENDFILE command. 
| 
|Delete specified nucleus extensions. 
| 
[Load a nuclé€us extension. 
| 
[Identify existing nucleus extensions. 
I 
|\Change the DOS/VS COBOL compiler (FCOBOL) options 
[that are in effect for the current terminal 
|session. 


|Load, relocate, and execute a load module from a 
{CMS LCALLIB or OS module library. 
| 
[Display a file that is in your virtual reader with— 
Jout reading it onto disk. 

OS PP |Compile and execute PL/I source code using the 
|PL/I Checkout Compiler. 


ee | 


Figure 4. 
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| Command | Code | Usage 

4 

| PLICR }OS PP |Execute the PL/I okject code generated by the OS 
; | |PL/I Checkout Compiler. 

| | | 

| PLIOPT 1OS PP |Compile PL/I source code using the OS PL/I 

| | [Optimizing Compiler. 

| | | 

[PRINT l |Spool a specified CMS file to the virtual printer. 
| | l 

| PSERV | [Copy a procedure from the VSE procedure library 

| | Jonto a CMS disk, display the procedure at the 

| i jterminal, or spool the procedure to the virtual 

; | {punch or printer. 

l l | 

| PUNCH [ |Spool a copy of a CMS file to the virtual funch. 
l | l 

{QUERY ; [|Request information about a CMS virtual machine. 
l | i 

IRDR [ [Generate a return code and either display or stack 
[ | ja message that identifies the characteristics of 
i i [the next file in your virtual reader. 

; l i 

|RDRLIST | [Display information about files in your virtual 

| ; [reader with the ability to issue commands from the 
i | J list. 

| | | 

JRECEIVE | [Read onto disk a file or note that is in your 

( | [virtual reader. 

[ [ [ 

{READCARD | {Read data from spooled card input device. 

l ; l 

|RELEASE | [Make a disk and its directory inaccessible to a CMS 
[ { [virtual machine. 

{ | 

|RENAME ; |Change the name of a CMS file or files. 

; l | 

|RSERV | [Copy a VSE relocatable module onto a CMS disk, 

| | [display it at the terminal, or spool a copy to 

| ; {the virtual punch or printer. 

[ | | 

| RUN | jInitiate series of functions to be performed on a 
| | |source, MODULE, TEXT, or EXEC file. 

[ | l 

[SCRIPT [SCRIPT |Format and print documents according to embedded 
| [ |SCRIPT control words in the document file. 

| | 

|ISENDFILE | |Send files or notes to one or more computer users, 
[ | Jattached locally or remotely, by issuing the 

l [ [command or by using a menu. (display terminal only) 
l | i 

ISENTRIES | [Determine the number of lines currently in the 

i | |Frogram stack. 

[ ( | 

| SET j |Establish, set, or reset CMS virtual nachine 

[ | | characteristics. 

[ | ; 

|SETPRT | {Load a virtual 3800 printer. 

| | [ 

[SORT ; {Arrange a specified file in ascending order 

[ ( 


{according to sort fields in the data records. 
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Figure 4. 
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|Command 
[ 

| SSERV 

| 


| 

| 

| 

| 

| 
[STATE 
| 
|STATEW 
| 
; 


SVCTRACE 


i 
[SYNONYM 
| 


I 

[TAPE 

[ 

| 

l 

| TAPEMAC 
I 

I 
{TAPPDS 
| 


| 
| TELL 


| 

| 

[ 

| TESTCOB 
| 

| TESTFORT 
I 


|TXTLIB 
; 

[TYPE 

| 
JUPDATE 
{ 

[ 

| VSAPL 

| 

| VSBASIC 
; 

| VSBUTIL 
H 

|XEDIT 

| 


| Code 


PP 


PP 


PP 


PP 


| Usage 


[ 

l 
[Copy a VSE source statement book onto a CMS | 
[disk, display it at the terminal, or spool a copy | 
[to the virtual punch or printer. | 
| l 
|Begin execution of programs previously loaded (OS | 
Jand CMS) or fetched (CMS/DOS). | 
| [ 
| Verify the existence of a CMS disk file. i 
l y 
[Verify a file on a read/write CMS disk. | 
| | 
|}Record information about supervisor calls. | 
| l 
[Invoke a table containing synonyms you have created | 
[for CMS and user—written commands. | 
l { 
|Perforg tape—to-—disk and disk—to—-tape operations [ 
[for CMS files, fposition tapes, and display or | 
[write VOL1 labels. | 
| { 
|Create CMS MACLIB libraries directly from an | 
| LEHMOVE—created partitioned data set on tape. \ 
| | 
|Load OS partitioned data set (PDS) files or card i 
J[image files from tape to disk. | 
| ; 
|Send a message to one or more computer users who | 
Jare logged on to your computer or to one attached | 
|to yours via RSCS. | 
| 

{ 

{ 

I 

l 

| 

| 

[ 

i 

| 

| 

| 

l 

l 

l 

( 

l 

| 

| 


| 

|Invoke the OS COBCL Interactive Debug Progran. 
| 
|Invoke the FORTRAN Interactive Debug Program. 


|Generate and modify text libraries. 


| 
[Display all or part of a CMS file at the terminal. 


| 
[Make changes in a program source file as defined 
{by control cards in a control file. 

l 
[Invoke VS AFL interface in CMS. 
| 
|Compile and execute VS BASIC programs under CMS. 


| 
iConvert BASIC 1.2 data files to VS BASIC format. 


| 
[Invoke the VM/SP System Product Editor to create or 
|modify a disk file. 


| a a a I a ee | 


Figure 4. 
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SYSGEN 


SYSGEN 


[Op Gd, 
J IPCS 
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| SYSGEN 
| 

| SYSGEN 
| 

|Op Gd, 
{SPG 


CMS Commands for System Frogrammers 


} 


[Assemble 370x source code. 
| 


|Regenerate the VM/SP assembler command modules. 
| 


[Generate a new CMS disk-resident module fron 
updated TEXT files. 

Generate the CMSSEG discontiguous saved segment. 
Format and edit system error records for output. 
Set up VM/SP directory entries. 

Load and save CMSDOS and INSTVSAM shared segments. 


Provide interactive analysis of CP abend dumps. 


Generate an EXEC file that assembles and link-—edits 
the 370x control progran. 


Update VM/SP or the VM/SP directory, or generate 
a new standalone copy of a service progran. 


Process CP spool reader files created by 370x 
dumping operations. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| Update IPCS protlen status. 

| 

|Enter a problem report in IPCS. 

| 

|Provide Programmakle Operator capability. 

| 

[Load and save the CMSBAM shared segment. 

| 

| storage and save an image on a CP—owned disk. 


Assign storage protect keys to storage assigned to 
named systems. 


Display the status of reported system problems. 


Allows the data collected by CPTRAP to be displayed 
or printed. 


Generate and/or update VM/SP using the PLC tape. 


distribution tare or SYSIN tape. 


Format and print system akend dumps; 


O under IPCS, 
create a problem report. 


Generate a new CP, CMS or RSCS module. 
Load and save CMSVSAM and CMSAMS shared segments. 


Modify or dump LOADLIB, TXTLIB, or MODULE files. 


| 
| 
| 
l 
| 
| 
| 
| 
| 
| 
| 
{Create CMS files for VSE modules from VSE library 
i 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


| 
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Section 2. CMS Commands 


This section contains reference information for the CMS commands used by 
general users. Each command description indicates the command format, 
operands and options; it also lists error messages and return codes the 
command issues. Usage notes are provided, where applicable. 


The formats of the LEBUG, EDIT, XEDIT, and EXEC commands are also 
listed; for details on the EDIT or DEBUG subcommands or EXEC control 
statements, see: 


e "Section 3. EDIT Subcommands and Macros" 
e "Section 4. DEBUG Sukcommands" 
e "Section 5. EXEC Control Statements" 


For details on the XEDIT subcommands and macros, see VM/SP: systen 
Product Editor Command and Macro Reference. 


For usage information on XEDIT sukcommands and macros, see VM/SP: 
System Product Editor User's Guide. 


For more detailed usage information on CMS commands, see the VM/SP CMS 
User's Guide. 
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ACCESS 


Use the ACCESS command to identify a disk to CMS, establish a filemnode 
letter for the files on the disk, and set up a file directory in 
storage. The specifications you make with the ACCESS command determine 
the entries in the user file directory. The format of the ACCESS 
command is: 


ACcess cuu mode[ /ext [fn [ft [f£m]]]] [ (options...[) ]] 
A * * * 


4131 


CE —_— | 
be ems oes oe a 


options: 
NOPROF 
ERASE 


i 
l 
| 
| 
| 
| 
| 
| NODISK 


where: 

cuu Makes available the disk at the specified virtual device 
address. The default value is 191. 

Valid addresses are 001 through 5FF for a virtual machine in 
basic control mode, and 001 through FFF for a virtual machine 
in extended ccntrol mode. 

.hode assigns a one—character filemode letter to all files on the 
disk being accessed. This field must be specified if cuu is 
Specified. The default value is A. 

ext indicates the mode of the parent disk. Files on the disk 


being accessed (cuu) are logically associated with files on 
the parent disk; the disk at cuu is considered a read-only 
extension. A blank must not precede or follow the slash (/). 


fn [ft [fnj] 

defines a subset of the files on the specified disk. Only the 
specified files are included in the user file directory and 
only those files can be read. An asterisk coded in any of 
these fields indicates all filenames, filetypes, or filemode 
numbers (except 0) are to be included. (See Usage Notes 3 and 
4.) To specify a filemode use a letter anda number, for 
example: B1. For OS and DOS disk access restrictions, see 
Usage Note 9. 


Options: 


NOPROF 
suppresses execution of a PROFILE EXEC file. This option is 
valid only if the ACCESS command is the first command entered 
after you IPL CHS. On subsequent ACCESS commands, the NOPROF 
option is ignored. 


ERASE specifies that you want to erase all of the files on the 


specified disk. This oftion is only valid for read/write 
disks. (See Usage Note 7.) 
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ACCESS 


NODISK 


lets you gain access to the CMS operating system with no disks 
accessed by CMS except the system disk (S-disk) and its 
extensions. This option is only valid if the ACCESS command 
is the first command you enter after you IPL CMS. 


Usage Notes 


1. 


If you have defined disk addresses 190, 191, 192, and 19E in the 
VM/SP directory, or if they are defined before you IPL CMS, these 
disks are accessed as the S-, A-, D-, and Y-disks respectively. 
Following an IPL of CMS, you must issue explicit ACCESS commands to 
access other disks. Crdinarily, you have access only to files with 
a filemode number of 2 on the system disk. 


When ACCESS is the first command issued after an IPL of the CMS 
system, the A-disk is not automatically defined. Another ACCESS 
command must be issued to define the A-disk. 

Associated with each CMS disk is a file directory, which contains 
an entry for every CMS file on the disk. The user file directory 
created in storage by the ACCESS command contains entries for only 
those files that you can reference. 

If you use the CP LINK command to link to a new minidisk, issue an 
ACCESS command each time. Do this so that you obtain the 
appropriate file directory. 


The filename, filetype, and filemode fields can only be specified 
for disks that are accessed as read-only extensions. For example: 


access 195 b/a * assemble 


gives you read-only access to all the files with a filetype of 
ASSEMBLE on the disk at virtual address 195. The command: 


access 190 z/a * * 21 


gives you access to all files on the system disk (190) that have a 
filemode number of 1. 


When you access any disk in read-only status, files with a filemode 
number of 0 are not accessed. 


You can also identify a set of files ona disk by referring toa 
filename or filetype prefix. For example: 


access 192 c/a abc* 


accesses only those files in the disk at virtual address 192 whose 
filenames begin with the characters ABC. The command line: 


access 192 c/a * a* c2 


gives you access to all files whose filetypes begin with an A and 
that have a filemode number of 2. 


You can force a read/write disk into read-only status by accessing 
it as an extension of another disk or of itself; for example: 


access 191 a/a 


forces your A-disk into read-only status. 
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ACCESS 


6. When a disk is made a read-only extension of another disk, commands 
that typically require or allow you to specify a filemode nay 
search extensions of the specified disk. The exceptions’ to this 


are the LISTFILE and CISK DUMP commands. For a detailed 
description of read-only extensions, see the VWM/SP CMS User's 
Guide. 


7. j$«mIf you enter the ERASE option by mistake, you can recover from the 
error as long as you have not yet written any new files onto the 
disk. (That is, you have not yet caused CMS to rewrite the file 
directory.) Reissue the ACCESS ccmmand without the ERASE option. 


8. You should never attempt to access a disk in read/write status if 
another user already has it in read/write status; the results are 
unpredictable. 


9. When accessing OS and DOS disks: 


a. You cannot specify filename, filetype and filemode when you 
access OS or DOS disks, nor can you specify any options. 


b. In order to see OS and DOS disks, you must have a read/write 
CMS A-disk available if you are going to use the LOAD command 
with the MAP option. (MAF is a default option.) 


10. If two or more disks have been accessed in CMS, andcCP DEFINE 
commands are executed that swap virtual addresses, then a 
Subsequent RELEASE command may write the file directory on the 
wrong disk; for exanfle: 


(CMS) ACCESS 193 C 
(CMS) ACCESS 198 E 
(CP) DEFINE 193 293 
(CP) DEFINE 198 193 
(CMS) RELEASE C 


This sequence of commands will write the file directory from 193 to 
198 since the CP definitions are unknown to CMS. 


11. To free an accessed disk, refer to the CMS RELEASE Command. 
Responses 


cr 1 

DMSACC723I mode (cuu) ) R/O /( [-OS | 

R/W | J|-DOS] 

L J 
If the specified disk is a CMS disk, this message is displayed if 
the disk is read-only. If the disk is in OS or DOS’ format, the 
message indicates the format, as well as whether it is a read/write 

or read-only disk. 


DMSACC724I cuul REPLACES mode (cuu2) 


Before execution of the command, the disk represented by cuu2 was 
the "mode" disk. The disk, cuul, iS now assigned that filemode 
letter. This message is followed by message DMSACC726I. 


{-DOS 

t 
The disk specified by cuu is the mode disk and an ACCESS command 
was issued to assign it another filemode letter. 


c 1 

DMSACC725I cuu ALSO = 'mode*® |-OS | DISK 
| 
| 
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DMSACC7261 


ACCESS 


*cuu modet RELEASED 


The disk being accessed at virtual address cuu aS a read/write disk 


is already accessed at a different 


mode. 


Other Messages and Return 


DMSACCOO2E 
DMSACCOO3E 
DMSACCO17E 
DMSACCO4S8E 
DMSACCO59E 
DMSACCO60E 


DMSACCO70E 
DMSACC109S 
DMSACC1125 
DMSACC113S 
DMSACC230W 
DMSACC240S 


mode. It is released from that 
Or, a disk currently accessed at mode is being replaced. 


Codes 


EER eICI 


FILE *DMSROS TEXT*' NCT FCUND RC=28 
INVALID OPTION "option RC=24 
INVALID DEVICE ADDRESS ‘cuut RC=24 
INVALID MODE ‘mode* RC=24 


"cuuf ALREALY ACCESSED AS READ/WRITE ‘mode* 
FILE(S) ‘fn [ft [fm]]* NOT FOUND. DISK ‘'mode(cuu) ! 
BE ACCESSED RC=28 

INVALID PARAMETER *parameter* RC=24 

VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 

DISK ‘mode(cuu)* DEVICE ERROR RC=100 

mode (cuu) NOT ATTACHED RC=100 

OS DISK - FILFID AND/OR OPTIONS SPECIFIED ARE IGNORED RC=4 
ERROR LOADING READ OS ROUTINE "DMSROS TEXT!* 


DISK RC=36 
WILL NOT 
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AMSERV 


Use the AMSERV command to invoke access method services to: 

e Define VSAM catalogs, data spaces, or clusters 

e Alter, list, copy, delete, export or import VSAM catalogs and data 
sets 


The format of the AMSERV command is: 


v ma | 

AMsServ fni1 {fn2| [ (options...[) }] 
|fn1| 
L 4 options: 


[PRINT] 


r 1 
[ITAPIN \'18n (| 
H TAPn 


TAPOUT Boe 
L J 


TAPn 


ec——4 
be em me od 


fn1 specifies the filename of a CMS file with a filetype of AMSERV 
that contains the access method services control statements to 
be executed. CMS searches all of your accessed disks, using 
the standard search order, to locate the file. 


fn2 specifies the filename of the CMS file that is to contain the 
access method services listing; the filetype is always 
LISTING. If fn2 is not specified, the LISTING file will have 
the same name as the AMSERV input file (fn1). 


The LISTING file’is written to the first read/write disk in 
the standard search order, usually your A-disk. If a LISTING 
file with the same name already exists, it is replaced. 


Options: 


PRINT spools the output listing to the virtual printer, instead of 
writing it to disk. If PRINT is specified, fn2 cannot be 
specified. 


TAPn 

specifies that tape input is on the tape drive at the address 
indicated by 18n or TAPn. n may be 1, 2, 3, or 4, indicating 
virtual addresses 181 through 184, respectively. 


TAPIN )18n 


TAPOUT )18n 
TAPn 

specifies that tape output should be written to the tape drive 

at the address indicated by 18n or TAPn. ao may be 1, 2, 3, or 

4, indicating virtual addresses 181 through 184, respectively. 


: If both TAPIN and TAPOUT are specified, their virtual device 
addresses must be different. 
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AMSERV 


Usage Notes 


1. To create a job stream for access method services, you can use the 
CMS Editor to create a file with the filetype of AMSERV. The 
editor automatically sets input margins at columns 2 and 72. 


2. Restrictions placed on VSAM usage in CMS are listed in this 
publication in "Appendix B: VSE/VSAM Functions Not Supported in 
CMS" and “Appendix Cs: OS/VS Access Method Services and VSAM 
Functions Not Supported in CMS." Refer to Using VSE/VSAM Commands 
and Macros for a description of access method services’ control 
Statements format and syntax. 


3. You must use the DLBL command to identify the master catalog. Disk 
input and output files may also require a DLBL command. For nore 
information on DLEL reguirements for AMSERV- see VSE/VSAM 
Programmer's Reference. 


4. When you use tape input and/or output with the AMSERV command, you 
are prompted to enter the ddnames; a maximum of 16 ddnames are 
allowed for either input and output. The ddnames can each have a 
maximum of seven characters and must be separated by blanks. 


While using AMSERV, only one tape at a time can be attached for 
either input or output. If you you enter more than one tape 
ddname, specify the tape files in the sequence they are used in the 
input strean. 


5. A CMS format variable file cannot be used directly as input to 
AMSERV functions as a variakle (V) or variable blocked (VB) file 
because the standard variable CMS record does not contain the BL 
and RL headers needed by the variable record modules. If these 
headers are not included in the record, errors will result. 


Most files placed on the CMS disk by AMSERV will show a RECFM of V, 
even if the true format is fixed (F), fixed blocked (FB), undefined 
(U0), variable or variable blocked. The programmer must’ know the 
true format of the file he is trying to use with the AMSERV command 
and access it properly, or errors will result. 


6. If an AMSERV command abnormally terminates or you issue HX to 
terminate an AMSERV command, the AMSERV environment may not be 
reset correctly. If a subsequent AMSERV abends, you must re-IPL 
CMS. 


Additional Note for CMS/DOS Users: 


AMSERV internally issues an ASSGN command for SYSIPT and locates the 
source file; therefore, ycu do not need to assign it. If you use the 
TAPIN or TAPOUT options, AMSERV also issues ASSGN ccmmands for the tape 
drives (assigning logical units SY¥S004 and S¥YS005). 


Any other assignments and DLBL definitions that are in effect when 
you invoke the AMSERV command are saved and restored when the command 
completes executing. 


Responses 


The CMS ready message indicates that access method services has 
completed processing. If access method services completed with a nonzero 
return code, the return code is shown in the ready message. Examine the 
LISTING file created by AMSERV to determine the results of access method 
services processing. 
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AMSERV 


The publication 
access method 


messages 
codes. 


DMSAMS367R 


This message prompts 


lists and explains the 
the associated reason 


VSE/VSAN Messages and Codes 
Services generates and 


ENTER TAPE {INPUT|[OUTPUT} DDNAMES: 


you to enter the ddnames associated with the 


tape files. 


DMSAMS7221 


This message is displayed when you enter 
listing is not being written on your 


FILE 'f£n2 LISTING fm" WILL HOLD AMSERV OUTPUT 
a £n2 operand or when the 


A-disk; it tells you the file 


identifier of the output listing. 


Qther Messages and Return Codes 


DMSAMSOO1E 
DMSAMSOO2E 
DMSAMSOO3E 
DMSAMSOO6E 
DMSAMSOO7E 
DMSAMSO65E 
DMSAMSO66E 
DMSAMSO70E 
DMSAMS109S 
DMSAMS113E 
DMSAMS136S 
DMSAMS228E 
DMSSTT062E 
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NO FILENAME SPECIFIED RC=24 
FILE 'fn1 AMSERV' NOT FOUND RC=28 
INVALID OPTION ‘option’ RC=24 

NO READ/WRITE DISK ACCESSED FOR 


"fn2 LISTING* RC=36 


FILE ‘f£n1 AMSERV fm' NOT FIXED, 80-CHAR. RECORDS RC=32 
"option! OPTION SPECIFIED TWICE RC=24 

"option! AND ‘eption' ARE CONFLICTING OPTIONS RC=24 
INVALID PARAMETEK ‘parameter' RC=24 


VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 
{TAPIN| TAPOUT} (addr) NOT ATTACHED RC=100 


UNABLE TO LOAD "IDCAMS* RC=104 
NO DDNAME ENTERED RC=24 
INVALID CHARACTER "char' IN FILEID {"fn1l AMSERV"{'fn2 


LISTING'} RC=20 
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ASSEMBLE 


Use the ASSEMBLE command to invoke the assembler to assemble a file 
containing source’ statements. Assembler processing and output is 
controlled by the options selected. The format of the ASSEMBLE command 
is: 


ee ee ee ee ee ee ee eee reer e: 
Assemble | fn [ (options...[) }] 


a | r ‘7 r ze | 
| [FLAG (nnn) | |LINECOUN (nn) | 
| {FLAG (0) | |LINECOUN (55) | 

J L J L J 


r 1 oF 1 1 
LIS [MCALL |  |MLOGIC | 


c 
I | 
NOLIST| |NOMCALL 
J L 


i | 

RLD | |LIBMAC | 
NORLD| [|NOLIBMAC| 
J L J 


l BCALL| NOS 
L a 4 J 


cr 1 rc 
|XREF (FULL) | |PRINT 
[XREF (SHORT) | |NOPRINT 
| NOX REF | |DISK 

J 


bee ee oe oe ol 


| cr ma | rc 7 

—t IQBYECT | JTEST | 

|NODECK| |NOOBJECT| |NOTESTI 

l J t J L J 

SYSTERM options: 

cr | cr | cr 71 
[INOMBER[| (S2NT | {IZERBINAL| 
[|NONUM | |NOSTMT| |NOTERM | 

L J l J l J 


c 7 c 7 r | 
[ALIGN | |BUFSIZE (MIN){ |RENT | 
|NOALIGN| |BUFSIZE (STD) | [NORENT| 
L 4 |BUFSIZE (MAX)| & 4 
Ll J 
r 7 i m | cr | 
|YFLAG | |SYSPARM (string)| |WCRKSIZE (2048K) | 
|NOYFLAG] |SYSPARM () | |WORKSIZE (nnnnnk) | 
L J  |SYSPARM (7?) ; oe J 
Ll J 


jes me ee eee eee es es ee ee ee ee ee a es eee ose ea a es ee sa es = oe == ol 


| 
| 
| 
| 
| 
l 
[ 
| 
| 
[ 
| 
| 
[ 
f 
| 
[ 
l 
{ 
| 
| 
| 
| 
| r 
| | DECK 
| 
| 
| 
| 
[ 
l 
[ 
| 
| 
; 
| 
l 
f 
; 
| 
| 
| 
I 
| 
[ 
[ 


where: 


fn is the filename of the source file to be assembled and/or the 
filename of assembler output files. The file must have 
fixed-length, 80-character records. By default, the assembler 
expects a CMS file with a filetype of ASSEMBLE. 
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Listing Control Options: The list below describes the assembler 


options you 


can use to control the assembler listing. The default 


values are underscored. 


ALOGIC 
NOALOGIC 
ESD 
NOESD 


FLAG (nnn) 
FLAG (0) 


LINECOUN (nn) 
LINECOUN (55) 


LIST 


NOLIST 


MCALL 


NOMCALL 


MLOGIC 


NOLIBMAC 


lists conditional assembly statements in open code. 
suppresses the ALOGIC option. 

lists the external symbol dictionary (ESD). 
suppresses the printing of the ESD listing. 


does not include diagnostic messages and MNOTE 
messages below severity code nnn in the listing. 
Diagnostic messages can have severity codes of 4, 8, 
12, 16, or 20 (20 is the most severe); and MNOTE 
message severity codes can be between 0 and 255. For 
example, FLAG (8) suppresses diagnostic messages with a 
severity code of 4 and MNOTE messages with severity 
codes of 0 through 7. 


nn specifies the number of lines to be listed per 
page. 


produces an assembler listing. Any previous listing is 
erased. 


does not produce an assembler listing. However, any 
previous listing is still erased. This option overrides 
ESD, RLD, and XREF. 


lists the inner macro instructions encountered during 
Macro generation following their respective outer macro 
instructions. The assembler assigns statement numbers 
to these instructions. The MCALL option is implied by 
the MLOGIC cption; NOMCALL has no effect if MLOGIC is 
specified. 


Suppresses the MCALL option. 


lists all statements of a Macro definition processed 
during macro generation after the macro instruction. 
The assemktler assigns statement numbers to then. 


suppresses the MLOGIC option. 


produces the relocation dictionary (RLD) as part of the 
listing. 


does not print the relocation directory. 


lists the macro definitions read from the macro 
libraries and any assembler statements following the 
logical END statement. The logical END statement is 
the first END statement processed during macro 
generation. It may appear in a macro or in open code; 
it may even be created by substitution. The assembler 
assigns statement numbers to the statements that follow 
the logical ENC statement. 


Suppresses the LIBMAC option. 
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XREF (FULL) includes inthe assembler listing a cross-reference 
table of all symbols used in the assembly. This 
includes symbols that are defined but never referenced. 
The assembler listing also contains a cross-reference 
table of literals used in the assembly. 


XREF (SHORT) includes in the assembler listing a cross-reference 
table of all symbols that are referenced in the 
assembly. Any symbols defined but not referenced are 
not included in the table. The assembler listing 
contains a cross-reference table of literals used in 
the assembly. 


NOX REF does not print the cross-reference tables. 
PRINT writes the LISTING file to the printer. 

PR 

NOPRINT suppresses the printing of the LISTING file. 
NOPR 

DISK places the LISTING file on a virtual disk. 
DI 


Output Control Options: The output control options are used to 
control the object module output of the assembler. 


DECK writes the object module on the device specified on the 
FILEDEF statement for PUNCH. If this option is 
specified with the OBJECT option, the object module is 
written both on the PUNCH and TEXT files. 


NODECK Suppresses the DECK option. 
OBJECT writes the object module on the device, which is 
BJ specified by the FILEDEF statement for TEXT, and erases 
any previous object modules. If this option is 


specified with the DECK option, the object module is 
written on the two devices specified inthe FILEDEF 
statement for TEXT and PUNCH. 


NOOBJECT does not create the object module. However, any previous 
NOOBJ object module is still erased. 
TEST includes the special source symbol table (SYM cards) in 


the object module. This option should not’ be used for 
programs to be run under CMS because the SYM cards are 
not acceptable to the CMS LOAD and INCLUDE commands. 


NOTEST does not produce SYM cards. 


SYSTERM Options: The SYSTERM options are used to control the SYSTERM 
file associated with your assembly. 


NUMBER writes the line number field (columns 73-80 of the 

NUM input records) in the SYSTERM listing for statements 
for which diagnostic information is given. This option 
is valid only if TERMINAL is specified. 


NONUM suppresses the NUMBER option. 


STMT writes the statement number assigned by the assembler 
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in the SYSTERM listing for statements for which 
diagnostic information is given. This option is valid 
only if TERMINAL is specified. 


NOSTMT Suppresses the STMT option. 
TERMINAL writes the diagnostic information on the 
TERM SYSTERM data set. The diagnostic information consists 


of the diagnosed statement followed by the error 
message issued. 


NOTERM Suppresses the TERMINAL option. 


Other Assembler Options: The following options allow you to specify 
various functions and values for the assembler. 


ALIGN aligns all data on the proper boundary in the 

ALGN object module; for example, an F-type constant is 
aligned on a fullword boundary. In addition, the 
assembler checks storage addresses used in machine 
instructions for alignment violations. 


NOALIGN does not align data areas other than those 

NOALGN specified in CCW instructions. The assembler does not 
skip bytes to align constants on proper boundaries. 
Alignment violations in machine instructions are not 
diagnosed. 


BUFSIZE (MIN) uses the minimum buffer sizes (790 bytes) for each of 
the utility data sets (SYSUIT1, SYSUT2, and SYSUT3). 
Storage normally used for buffers is allocated to work 
space. Because more work space is available, more 
complex programs can be assembled ina given virtual 
Storage size; but the speed of the assembly is 
substantially reduced. 


BUFSIZE (STD) chooses the buffer size that gives optimum performance. 
The buffer size depends on the amount of virtual 
Storage. Of the assembler working storage in excess of 
minimum requirements, 37% is allocated to the utility 
data set buffers and the rest to macro generation 
dictionaries. 


BUFSIZE (MAX) is useful when many macros and/or large macros are used 
in an assembly. The assembler uses up to 15 save areas 
for input records and saves the areas according to 
their frequency of use, optimizing the macro generation 
phase. This option has no effect unless a large enough 
region is available. The number of allocated save 
areas is printed on the Statistics page of the 
assembler listing. | 


Refer to the OS/VS-VH/370 Assembler Programmer's Guide, 
Appendix E for a description of the effects of BUFSIZE. 


RENT checks your program for a possible violation of program 
reenterability. Code that makes your prograa 
nonreenterable is identified by an error message. 


NORENT suppresses the RENT option. 

YFLAG does not suppress the warning messages that indicate 
that relocatable Y-type address constants have been 
declared. 


30 IBM VM/SP CMS Command and Macro Reference 


U 


WORKSIZE 


ASSEMBLE 


OYFLAG suppresses the warning messages that indicate 


relocatable Y-type constants have been declared. 


Q) 
(2) 


SYSPARM oo 


passes a character value to the system variable symbol, 
SYSPAR#. The variable (string) may be up to _ 4100 
characters long, and may not contain any blanks or 
parentheses. If you want to enter a string containing 
blanks or parentheses, use the SYSPARM (?) format. 
With the SYSPARM (7?) format, CMS prompts you with the 
message: 


ENTER SYSPARA: 


You can enter up to 100 characters. SYSPARM () enters 
a null string of characters. 


Note: If ASSEMBLE is called aS a command, the SYSPARS 
information is translated to uppercase. 


(2048K) 
(nnnnnk) 
allows the user to delimit the use of region space. The 
specified value does not include the space for nodules 
and system areas. The allowed range is from 32K to 
10240K. The virtual machine size must be large enough 
~ to accommodate the WORKSIZE option; otherwise _ the 
option has no effect. 


Usage Notes 


1. 


When you issue the ASSEMBLE command, default FILEDEF commands are 
issued for assembler data sets. You may want to override these 
with explicit FILEDEF commands. The ddnames used by the assembler 
are: 


ASSEMBLE (SYSIN input to the assembler) 
TEXT (SYSLIN output of the assembler) 
LISTING (SYSPRINT output of the assembler) 
PUNCH (SYSPUNCH output of the assembler) 
CMSLIB (SYSLIB input to the assembler) 
SYSUT1 (workfile of the assembler) 

SYSUT2 (workfile of the assembler) 

SYSUT3 (workfile of the assembler) 


The default FILEDEF commands issued by the assembler for’ these 
ddnames are: 


FILEDEF ASSEMBLE DISK fn ASSEMBLE fm (RECFM FB LRECL 80 BLOCK 800 
FILEDEF TEXT DISK fn TEXT fon 

FILEDEF LISTING DISK fn LISTING fm (RECFM FBA BLOCK 1210 

FILEDEF PUNCH PUNCH 

FILEDEF CMSLIB DISK CMSLIB MACLIB * (RECFM FB LRECL 80 BLOCK 800 
FILEDEF SYSUT1 DISK fn SYSUT1 fm4 (BLOCK 7294 AUXPROC asmproc 
FILEDEF SYSUT2 DISK fn SYSUT2 fm4 (BLOCK 7294 AUXPROC asmproc 
FILEDEF SYSUT3 DISK fn SYSUT3 f£m4 (BLOCK 7294 AUXPROC asmproc 


At the completion of the ASSEMBLE command, all FILEDEFs that do not 
have the PERM opticn are erased. 


If you want to use any CMS macro or copy libraries during an 
assembly, issue the GLOBAL command to identify the macro libraries 
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before you issue the ASSEMBLE command. For example: 


global maclib dmssp cmslib osmacro testlib 


identifies the MACLIB files named CMSLIB, DMSSP, OSMACRO, and 
TESTLIB. 


3. To use OS macro libraries during an assembly, issue the FILEDEF 
command for the OS data set. Use a ddname of CMSLIB and assign a 
CMS file identifier; the filetype must be MACLIB, and you must use 
the filename on the GLOBAL command line. For example: 


filedef cmslib disk oldtest maclib c dsn oldtest macros 
global maclib oldtest 


assigns the OS data set OLDTEST.MACROS, on the disk accessed as 
mode C, acCMS fileid of OLDTIEST MACLIB and identifies it as the 
macro library to be used during assembly. 


4. You cannot assemble programs using DOS macros from the DOS/VS 
source statement libraries under CMS/DOS. You should use _ the 
SSERV, ESERV, and MACLIB commands to create CMS MACLIBs to contain 
DOS macros for assemkEly under CHS/DOS. See the VM/SP CMS User's 
Guide for examples. 


5. You need not make any logical assignments for input or output files 
when you use the assembler under CMS/DOS. File definitions are 
assigned by default under CMS, as described in Usage Note 1. 


6. Usage information about the VM/SP Assembler Language and assenbler 
options can be found in OS/VS and V¥/370 Assembler Programmer's 
Guide and OS/VS, DOS/VS, and VM/370 Assembler Language. 


Messages and Return Codes 


eae 


For the messages and return codes associated with the ASSEMBLE command, 
see the OS/VS and VM/370 Assembler Programmer's Guide. 


a ai ene Sears Eqs GEN ainda 
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Use the ASSGN command in CMS/DOS to asSign or unaSsSign a system or 
programmer logical unit for a virtual I/O device. The format of the 
ASSGN command is: 


| ASSGN | SY¥Sxxx | Reader [ (options...[) ]] | 
| | PUnch | 
] | PRinter { 
| | Terminal options: | 
| | r4 l 
[ l TAP[n| r 1 c 1 l 
| | 11] |UPCASE | | 7TRACK| [TRTCH a] | 
| | Lt 4 | LOWCASE| | ITRACK | | 
| | mode t J L J [DEN den} | 
| | IGN 
[ I UA l 


ee eee | 


where: 

SYSxxx specifies the system or programmer logical unit to be assigned 
to a particular physical device. SYSO000 through SYS241 are 
valid programmer logical units in CMS/DOS; they may be 
assigned to any valid device. The system logical units you 
May assign, andthe devices to which they may be assigned, 
are: 

SYSxxx Valid assignments 

SYSRDR Reader,disk, tare 

SYSIPT Reader,disk,tare 

SYSIN Reader,disk, tare 

SYSPCH Punch,disk,tape 

SYSLST Printer, disk,tape 

SYSLOG Terminal, printer 

SYSOUT Tape 

SYSSLB Disk 

SYSRLB Disk 

SYSCLB Disk 

SYSCAT Disk 
The assignment of a system logical unit to a particular device 
type must be consistent with the device type definition for 
the file in your frogran. 

READER is the spooled card reader (card reader I/O must not be 
blocked). 

PU NCH is the spooled punch. 


PRINTER is the spooled printer. 

TERMINAL is your terminal (terminal I/O must not be blocked). 

TAP[n ] is a magnetic tare. n is the symbolic number of the tape 
drive. It is either 1, 2, 3, or 4, representing virtual 
addresses 181, 182, 183, and 184, respectively. If n is 
omitted, TAP1 is assumed. 

mode specifies the one-character mode letter of the disk being 
assigned to the logical unit (SYSxxx). The disk must be 


Section 2. CMS Commands 33 


ASSGN 


accessed when the ASSGN command is issued. SYSRDR, SYSIPT, 
and SYSIN cannot be assigned to a DOS-formatted FB-512 disk. 


IGN (ignore) specifies that any attempt to read from the specified 
device results in an end-of-file indication; any attempt to 
write to the device is ignored. IGN is not valid when 
associated with SYSRDR, SYSIPT, SYSIN, or SYSCLB. 


UA indicates that the logical unit is to be unassigned. When you 


release a disk for which an assignment is active, it is 
automatically unassigned. 


Options: 


UPCASE translates all terminal input data to uppercase. 


LOWCASE 
retains all terminal input data as keyed in. 


7TRACK is the tape setting. 


STRACK 
TRICH a 
refers to the tape recording technique for 7-track tapes. Use 
the following chart to determine the value of a. 
aaa Aaa 
{ ae | Parity | Converter | Translator i 
( l 
[| oOo | odd [ off | off i 
{; oc | odd [ on | off | 
}] OT | odd | off [ on | } 
| -E | even | off | off | 
| ET | even { off [ on | 
| a ne ne ee | 
DEN den 


is tape density: den can be 200, 556, 800, 1600, or 6250 bits 
per inch (bpi). If 200 or 556 are specified, 7TRACK is 
assumed. If 800, 1600, or 6250 are specified, 9TRACK is 
assumed. (See Usage Note 8.) 


Usage Notes 
1. When you enter the CMS/DOS environment with the command SET DOS ON, 
SYSLOG is assigned by default to TERMINAL. If you specify the mode 
letter of the VSE system residence on the SET DOS ON command line, 
SYSRES is assigned to that disk mode. 


2. You cannot assign any of the following VSE system logical units 
with the ASSGN command: 


SYSRES SYSLNK SYSDMP 
SYSCTL SYSREC 


3. If you assign the logical unit SYSIN to a virtual device, SYSEDR 
and SYSIPT are also assigned to that device. If you make a logical 
asSignment for SYSOUT, both SYSLST and SYSPCH are assigned. 


4. To obtain a list of current assignments, use the LISTIO command. 
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5. To cancel all current assignments (that is, to unassign them), you 


can enter, in succession, the commands: 


set dos off 
set dos on [mode] 


6. If you want to access VSE private libraries, you must assign the 
logical units SYSSLB (source statement library), SYSRLB 
(relocatable library), and S¥YSCLB (core image library), and you 


must issue the DLBL ccmmand to establish a file definition. 


7. An asSignment to disk (mode) should be accompanied by a 
command that provides the disk file identification. 


DLBL 


8. If no tape options are specified on the command line, the default 
for a 7-track tape is 800 bpi, data converter off, translator off 
and odd parity. If the tape is 9-track, the density defaults to 
the density of the tape drive. 1600 bpi is the reset condition for 
9-track dual-density tapes. If the tape drive is phase-encoded, 
density defaults to the density of the tape. If the tape drive is 


NRZI, the reset condition is 800 bpi. 


9. 8809 tape drives require the 9TRACK and DEN 1600 options. 
are the default options; it is not necessary to. state 
explicitly. 


These 
then 


10. Assignment of Programmer Logical units to 'T* and 'R* is restricted 


to terminal and reader respectively. 


Responses 


None. 


Messages and Return Codes 


DMSASNOO3E INVALID OPTION ‘option' RC=24 

DMSASNO27E INVALID DEVICE 'device* RC=24 

DMSASNO28E NO LOGICAL UNIT SPECIFIED RC=24 

DMSASNO29E INVALID PARAMETER ‘parameter’ IN THE OPTION ‘option' 
FIELD RC=24 

DMSASNO35E INVALID TAPE MODE RC=24 

DMSASNOSOE PARAMETER MISSING AFTER SYSxxx RC=24 

DMSASNO65E ‘foptiont OPTION SPECIFIED TWICE RC=24 

DMSASNO66E 'option' AND ‘option ARE CONFLICTING OPTIONS RC=24 

DMSASNO69E DISK 'modet NOT ACCESSED RC=36 

DMSASNO7VOE INVALID PARAMETER ‘parameter' RC=24 

DMSASNO87E INVALID ASSIGNMENT of "SYSxxx' TO DEVICE ‘device’ RC=24 

DMSASNOQSOE INVALID DEVICE CLASS ‘deviceclass' FOR ‘device' RC=36 

DMSASNOS9JE CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 


DMSASN113S *{TAPn|]mode|READER|PUNCH| PRINTER} (cuu)* NOT ATTACHED RC=100 
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Use the CMDCALL command in an EXEC 2 procedure to allow certain CMS 
commands (ERASE, LISTFILE, RENAME, and STATE) to display the message 
"FILE NOT FOUND*'. CMDCALL accomplishes this by converting the EXEC 2 
extended plist function calls to CMS extended plist command calls. The 
format of the CMDCALL command is: 


RS Iai ai aa aR ma | 
{CMDCALL| [cmd [operandi [operand2 ... operandn jj] i 
a Nh ee ee 


wheres: 

cnd is the command that is to be invoked with the CMS extended 
plist, indicating invocation as a command, rather than asa 
function. 


operand! operand2 ... 
are the operands to be passed with the conmand. 


Usage Notes: 


1. The extended plist and the standard CMS plist are adjusted for the 
command or function called, and that command or function is 
invoked via SVC 202. 


2. If an extended plist is not available, the command or function 
called is invoked only with the standard plist adjusted for the 
command or function called. 


3. CMDCALL invoked with no calling command or function returns a 
return code of zero. Otherwise, the return code is that of the 
command invoked via the CMDCALL function. 


4. If the high-order byte of register 1 contains a X'01', it is 
Changed to X*OB'*. 
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CMSBATCH 


The system operator uses the CMSBATCH command to invoke the CMS batch 
facility. Instead cf compiling or executing a program interactively, 
virtual machine users can transfer jobs to the virtual card reader of an 
active CMS batch virtual machine. This frees their terminals for other 
work. The format of the CMSBATCH command is: 


(SR Ra aA a a a RG a a a a | 
| CMSBATCH | [sysname ] | 
I ee 


where: 


sysname is the eight-character identification of the saved system that 
is specifically generated for CMS batch operations via the CP 
SAVESYS command andthe NAMESYS macro. Refer to the VM/SP 
System Programmer's Guide. for details on SAVESYS and NAMESYS 
use. 


Note: If sysname is not supplied on the command line, then the 
system that the system operator is currently logged onto 
becomes the CMS batch virtual machine. 


Usage Notes 


1. The CMSBATCH command may be invoked immediately after an IPL of the 
CMS systen. Alternatively, BATCH may be specified following the 
PARM operand on the IPL command line. 


2. Do not issue the CMSBATCH command if you use a virtual disk at 
address 195; the CMS batch virtual machine erases all files on the 
disk at address 195. 


3. For a description of how to send jobs to the CMS batch virtual 
Machine, see the VM/SP CMS User's Guide. For an explanation of 
setting up a batch virtual machine, see the VM/SP Operator's Guide. 


4. The CMS batch virtual machine can be utilized by personnel who do 
not have access to aterminal or a virtual machine. This is 
accomplished by submitting jobs via the real card reader. For 
details on this, see the VM/SP CMS User's Guide. 


5. If the CMSBATCH command encounters recursive abends, the message 
"CMSBATCH system ABEND" appears on the system operator's console. 


Error Messages and Return Codes 


DMSBTB100E NO BATCH PROCESSOR AVAILABLE RC=40 

DMSBTB101E BATCH NOT LOADED RC= 88 

DMSBTP105E NO JOB CARD FRCVILTED RC=None 

DMSBTP106E JOB CARD FORMAT INVALID RC=None 

DMSBTP107E CP/CMS COMMAND ‘command, (device)* NOT ALLOWED RC=88 
DMSBTP108E /SET CARD FORMAT INVALID kC=None 

DMSBTP109E {CPU| PRINTER| PUNCH} LIMIT EXCEEDED kRC=None 
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Use the COMPARE command to compare two CMS disk files of fixed- or 
variable-length format on a record-for-record basis and to display 
dissimilar records at the terminal. The format of the COMPARE command 
is: 


COMpare fileid1 fileid2 [ (option...) } 


OQ 
oO 
re 


wheres: 


fileid1 fileid2 

are the file identifiers of the files to be compared. An 
egual sign may be coded for one or more of the file 
identifiers for fileid2 in any combination except '= = ='*, 
All three file identifiers (filename, filetype, filemode) must 
be specified for each fileid. An equal sign (=) coded in 
fileid2 implies that the file identifier in that position is 
identical to the corresponding file identifier in fileid1. 


Options: 


cr 
COL {ma[—]nn 


bee ee ee ee ot 


| 
[1 lrecl 
L 


defines specific columns to be compared. The comparison 
begins at position mm of each record. The comparison proceeds 
up to and including column nn. The hyphen (-) may be used in 
place of a blank if the total number of characters required 
for mm-nn is not more than eight (f@aximum parameter length). 
If column on is specified, the hyphen may not follow or 
precede a blank. If column nn is not specified, the default 
ending position is the last character of each record (the 
logical record length). 


Usage Notes 


1. To find out whether two files are identical, enter both file 
identifications, as follows: 


compare test1 assemble a test1 assemble b 
OL 
compare test1 assegpble a = = b 
Any records that do not match are displayed at the terminal. 


2. To stop the display of dissimilar records, use the CMS Immediate 
command HT. 
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3. If a file does not exist on a specified disk, the read-only 
extensions of that disk are also searched. The complete fileids of 
the files being compared are displayed in message DMSCMP1791. 


Responses 


DMSCMP179I COMPARING ‘fn £t fm" WITH ‘fn ft fn 


This message identifies the files being compared. If the files are 
the same (in the columns indicated), this message is followed by 
the CMS ready message. If any records do not match, the records 
are displayed. When all dissimilar records have been displayed the 
message DMSCMP209W is issued. 


Other Messages and Return Codes 


DMSCMPOO02E 
DMSCMPOO3E 


DMSCMPOOSE NO COLUMN SPECIFIED RC=24 

DMSCMPOOSE COLUMN "colt EXCEEDS RECORD LENGTH RC=24 

DMSCMPO10E PREMATURE EOF ON FILE ‘fn ft fm* RC=40 

DMSCMPO011E CONFLICTING FILE FORMATS RC=32 

DHSCMPO19E IDENTICAL FILEIDS RC=24 

DMSCMPO29E INVALID PARAMETEK ‘parameter' IN THE OPTION ‘'COL* FIELD 
RC=24 

DMSCMPOS4E INCOMPLETE FILEID SPECIFIED RC=24 

DMSCMPO62E INVALID * IN FILEID RC=20 

DMSCMPO69E DISK ‘mode NOT ACCESSED RC=36 

DMSCMP104S ERROR ‘nn' READING FILE ‘fn ft fm" FROM DISK RC=100 

DMSCMP209W FILES DO NCT COMEARE RC=4 


DMSCMHP211E 


FILE ‘fn £t fm" NOT FOUND RC=28 
INVALID OPTION ‘option RC=24 


COLUMN FIELDS CUT OF SEQUENCE RC=24 
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Use the CONWAIT command to cause a program to wait until all pending 
terminal I/O is complete. The format of the CONWAIT command is: 


foe ee oe WN tte Se eee Sa Ee Ey ee ee ee eee ee ee ee, ae eS CS eS ge ee ee ee 1 
] CONWAIT | i 
bio aa ee Sa Se a ea ae ee ee a ee ee ee a ere ee ee eae J 
Usage Note 


The CONWAIT command synchronizes input and output to the terminal; it 
ensures that the output console stack is cleared before the progran 
continues execution. Also, you can ensure that a read or write 
operation is finished before you modify an I/O buffer. 
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Use the COPYFILE command to copy and/or modify CMS disk files. The 
Manner in which the file identifiers are entered determines whether or 


not one or 


command is: 


CoPyfile 


more output files are created. The format of the COPYFILE 


fileidil [fileidi2...] [fileido] [ (options...j) ]] 


l 

[ 

options: l 
r 1 =f 1 =F 1 =f 1 l 
[Type | |[NEWDate| |NEWFile| |PRompt | | 
INOType| [|OLDDate| |REPlace| |NOPRompt] | 
L J L J L J J | 
r 1 ~=O6F 1 °=«O9f 7 l 
|FRom recno | {FOR numrec j iSPecs | | 
|FRLabel xxxxxxxx| [TOLabel xxxxxxxx| |NOSPecs| | 
L J L J L J | 
r 1 =F 1 r 1 [ 
}ovly | [RECfm \F/| [LRecl nnonnn] [TRUnc | | 
| APpend| | Ht {NOTRunc| | 
L J Lt J L J i 
r 1 =F 1 r 1 i 
[PAck | |FIll c | [EBcdic] [UPcase | [TRAns] | 
| UNPack | [FI1l1 hh| | LOwcase | | 
: 4 {FI11 401 : 4 l 
[SIngle] t 4 | 


a ae Ne ee a ee en ee | 


where: 


fileidil 


fileidi2 


fileido 


is the first (or only) input file. Each file identifier 
(filename, filetype, and filemode) must be specified either 
by indicating the specific identifier or by coding an 
asterisk. 


is one or more additional input files. Each file identifier 
(filename, filetype, and filemode) must be specified. In 
Single output mode, any of the three input file identifiers 
may be specified either by indicating the specific 
identifier or by coding an asterisk. However, all three 
file identifiers of fileidi2 cannot be specified by 
asterisks. In nultiple output mode, an asterisk (*) is an 
invalid file identifier. An equal sign (=) may be coded for 
any of the file identifiers, indicating that it is the sane 
as the corresponding identifier in fileidil. 


is the output file(s) to be created. Each file identifier 
(filename, filetype, and filemode) must be specified. To 
create multiple output files, an equal sign (=) nust be 
coded in one or more of the identifier fields. If there is 
only one input file, fileido may be omitted, in which case 
it defaults to = = = (the input file represented by fileidil 
is replaced). 


The COPYFILE command options are listed below, briefly. For usage 
notes and examples, see "Using the COPYFILE Command" following the 
option descriptions. 
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Options: 
TYPE 


REPLACE 


PROMPT 


NOPROMPT 


displays, at the terminal, the names of the files being 
copied. 


Suppresses the display of the names of the files being 
copied. 


uses the current date as the creation date of the new 
file(s). 


uses the date on the (first) input file as the creation 
date of the new file(s). 


checks that files with the same fileid as the output file 
do not already exist. If one or more output files do 
exist, an error message is displayed and the COPYFILE 
command terminates. This option is the default so that 
existing files are not inadvertently destroyed. 


causes the output file to replace an existing file with 
the same file identifier. REPLACE is the default option 
when only one fileid is entered or when the output fileid 
is specified as "= = =," 


displays the messages that request specification or 
translation lists. 


Suppresses’ the display of prompting messages for 
Specification and translation lists. 


Copy Extent Options: 


FROM recno 


is the starting record number for each input file in the 
copy operation. 


FRLABEL xXxxxxxxx 


FOR numrec 


XXXXXXxX is a character string that appears at the 
beginning of the first record to be copied from each 
input file. Up to eight nonblank characters may be 
specified. 


is the number of records to be copied from each input 
file. 


TOLABEL xxxxxxxx 


SPECS 


xxXxxxXxxx iS a character string which, if at the beginning 
of a record, stops the copy operation for that input 
file. The record containing the given character is not 
copied. Up to eight nonblank characters may be specified. 


indicates that you are going to enter a_ specification 
list to define hcw records should be _ copied. See 
"Entering a COPYFILE Specification List" for information 
on how you can define output records in a specification 
list. 


indicates that no specification list is to be entered. 
overlays the data in an existing output file with data 


from the input file. You can use OVLY with the SPECS 
option to overlay data in particular columns. 
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APPEND appends the data from the input file at the end of the 
output file. 


Data Modification Qptions: ‘The following options can be used to 
change the record format of a file. See “Modifying Record Formats" 
for more details. 


RECFM F is the record format of the output files. If not 
V specified, the output record format is the same as that 
of the input file. 


LRECL nnonnnn is the logical record length of the output file(s) if it 
is to be different from that of the input file(s). The 
maximum value of nnnnn is 65535. 


TRUNC renoves trailing Elanks (or fill Characters) when 
converting fixed-length files to variable-length format. 


NOTRUNC Suppresses the removal of trailing blanks (or fill 
characters) when converting fixed-length files to 
variable-length fornat. 


PACK compresses records in a file so that they can be stored 
in packed format. 


Caution: A file in packed format should not be nodified 
in any way. If such a file is modified, the UNPACK 
routines are unable to reconstruct the original file. 


UNPACK reverses the PACK operation. If a file is inadvertently 
packed twice, you can restore the file to its original 
unpacked form by issuing the COPYFILE command twice. 


FILL c is the padding and truncation character for the TRUNC 
FILL hh option or the principal packing character for the PACK 
FILL 40 option. The fill character may be specified as a single 


character, c, or by entering a two-digit hexadecinal 
representation of a character. The default is 40 (the 
hexadecimal representation for a blank in EBCDIC). 


Character Translation Options: 


EBCDIC converts a file that was created with 026 keypunch 
characters (BCD), to 029 keypunch characters (EBCDIC). 
The following conversions are nade: 


to 
to 
to 
to 
to 
to 


= % ae Mp. 
co oe i om +e 


UPCASE converts all lowercase characters in each record to 
uppercase before writing the record to the output file. 


LOWCASE converts all uppercase characters in each record to 
lowercase before writing the record to the output file. 


TRANS indicates that you are going to enter a list of character 
translations to be made as the file is copied. See 
"Entering Translation Specifications" for details on 
entering a list of characters to be translated. 
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SINGLE Suppresses multiple output mode regardless of how the 
file identifiers are specified. 

Incompatible Options 
Figure 6 shows combinations of options that should not be specified 
together in the same COPYFILE command. If the option in the first 
column 1s specified, do not code any of the options in the second 
column. 
| Option | Incompatikle Options l 
| ; 
| APPEND {| LRECL, NEWDATE, NEWFIIE, OLDDATE, OVLY, PACK, RECFH, | 
[ { REPLACE, UNPACK ; 
| EBCDIC {| PACK, UNPACK | 
| FOR | PACK, TOLABEL, UNPACK | 
| FRLABEL | FROM, PACK, UNPACK { 
| FROM | FRLABEL, PACK, UNPACK | 
| LOWCASE | PACK, UNPACK | 
| LRECL | APPEND, PACK, UNPACK | 
{ NEWDATE | APPEND, OLDDATE 
| NEWFILE | APPEND, OVLY, REPLACE [ 
{| NOPROMPT | PROMPT i 
| NOSPECS {| SPECS ( 
{| NOTRUNC | TRUNC | 
| NOTYPE | TYPE [ 
| OLDDATE | APPEND, NEWDATE 
| OVLY | APPEND, NEWFILE, PACK, REPLACE, UNPACK | 
| PACK | APPEND, EECDIC, FOR, FRLABEL, FROM, LOWCASE, LRECL, | 
| [ OVLY, RECFH, SPECS, TOLABEL, TRANS, TRUNC, UNPACK, I 
| | UPCASE | 
{| PROMPT | NOPROMPT | 
| RECFM | APPEND, PACK, UNPACK { 
| REPLACE | APPEND, NEWFILE, OVLY { 
| SPECS | NOSPECS, PACK, UNPACK i 
| TOLABEL | FOR, PACK, UNPACK | 
| TRANS | PACK, UNPACK ; 
| TROUNC | NOTRUNC, PACK, UNPACK i 
| TYPE | NOTYPE | 
| UNPACK { APPEND, EECDIC, FOR, FRLABEL, FROM, LOWCASE, LRECL, | 
| | OVLY, PACK, RECFM, SPECS, TOLABEL, TRANS, TRUNC, [ 
| | UPCASE | 
| UPCASE {| PACK, UNPACK [ 


Ca re car eae a rg a re eee a ee eT 
Figure 6. COPYFILE Option Incompatibilities 


USING THE COPYFILE CCMMAND 


Two simple uses of the COPYFILE command are: (1) to 
file from one disk to ancther, or (2) to make a duplicate 
file on the same disk. For example: 


copy a single CMS 
copy of the 


copyfile test1 assemble a test2 assemble a 


makes a copy of the file TEST1 ASSEMBLE A and names it TEST2 ASSEMBLE A. 
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For those portions of the file identifier that you want to stay the 
Same, you may code an equal sign in the output fileid. Thus, _ the 
command line above can be entered: 


copyfile test1 assemble a test2 = = 


The egual sign may be used as a prefix or suffix of ae file 
identifier. For example, the command: 


copyfile a bc file= type= = 
creates an output file called FILEA TYPEB C. 


When you copy a file from one virtual disk to another, you specify 
the old and new filemodes, and any filename or filetype change you want 
to make; for example; 


copyfile test3 assemble c good =a 


This command makes a copy of the file TEST3 ASSEMBLE C, and names it 
GOOD ASSEMBLE A. 


If you want to copy only particular records ina file, you can use 
the FROM/FOR FRLABEL/TOLABEL options. For example: 


copyfile old test a new test a (frlabel start for 41 


copies 41 records from the file OLD TEST A1, beginning with the record 
Starting with the character string START into the file NEW TEST Al. 
Since the user's command line, as passed to COPYFILE in the PLIST, has 
been translated into uppercase letters, any FRLABEL or TOLABEL character 
string consisting of either all lowercase or mixed case letters is not 
found in the input file. Error message DMSCPY157E is issued if the 
FRLABEL character string is not found. If the TOLABEL character string 
is not found, the copy operation continues as if TOLABEL was not 
specified. 


Note: If the input filemode is an ‘'**', then you should specify an 
explicit filemode, not an ‘'=', for the output filemode. If you do not 
specify an explicit output filemode, it is possible to create an output 
file that would be recognized as an input file which generates the error 
message DMSCPYO24E stating that the file already exists. For example, 
if you have a file ' C B At and you issue the command 'COPY C * * =D 
=", COPY creates an output file named 'C D A*. This file matches the 
input fileid of the file 'C * ** and copy attempts to write an output 
file with the name 'C D A*, which already exists. 


Multiple Input and Output Files 
You can combine two or more files into a single file with the COPYFILE 
command. For example: 

copyfile test datal a test data2 = test data3 b 


copies the files TESTI DATA1 and TEST DATA2 from your A-disk and combines 
them into a file, TEST DATA3, on your B-disk. 


Note that if any input file has a filemode number of 3, it is 
possible that the file will be copied in a sequence different from its 
order on the disk. 


If you want to combine two more files without creating a new file: 
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use the APPEND option. fFor example: 
copyfile new list a old list a (append 


appends the file NEW LIST A to the bottom of the existing file labeled 
OLD LIST A. 


Note: If the file NEW LIST A has a different LRECL from the file OLD 
LIST A, the appended data is padded, or truncated, to the LRECL of the 
file OLD LIST A. 

Whenever you code an asterisk (*) in an input fileid, you may cause 
one or more files to be copied, depending upon the number of files that 
satisfy the remaining conditions. For example: 

copyfile * test a combined test a 
copies all files with a filetype of TEST on your A-disk into a Single 
file named COMBINED TEST. If only one file with a filetype of TEST 
exists, only that file is corpied. 


If you want to copy all the files on a particular disk to another 
disk, you could enter: 


copyfile * * b== a 


All the files on the B-disk are copied to the A-disk. The filenames and 
filetypes remain unchanged. 


You can also copy a group of files and change all the filenames or 
all the filetypes. For example: 


copyfile * assemble b = test a 


copies all ASSEMBLE files in the B-disk into files with a filetype of 
TEST on the A-disk. The filenames are not changed. 


You can use the SINGLE option to override multiple output mode. For 
example: 


copyfile * test a = = B (single 
copies all files on the A-disk with a filetype of TEST to the B-disk as 
one combined file, with the filename and filetype egual to the first 
input file found. 
Whenever an asterisk appears, it indicates that all files are to be 
copied; whenever an equal sign (=) appears, it indicates that the same 
files are to be copied. For example: 


copyfile x * a1 = file = 


combines all files with a filename of X on the A-disk into a single file 
named X FILE Al. 


Whenever an equal sign appears inthe output fileid in a position 
corresponding to an asterisk in an input fileid, multiple input files 
produce multiple output files. When you perform copy operations of this 
Rature you might wish to use the TYPE option, which displays the names 
of files being copied. For example: 

copyfile * test a = output a = summary = (type 


Right result in the display: 
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COPY "ALPHA TEST A1* TO "ALPHA SUMMARY Al" (NEW FILE) 
COPY "ALPHA OUTPUT A* 

COPY "BETA TEST A1l* TO "BETA SUMMARY A1* (NEW FILE) 
COPY "BETA OUTPUT A.* 


which indicates that files ALPHA TEST A and ALPHA OUTPUT A were copied 
into a file named ALPHA SUMMARY A and that files BETA TEST A and BETA 
OUTPUT A were copied into a file named BETA SUMMARY A. 


You can use the RECFM and LRECL options to change the record format of a 
file as you copy it. For example: 


copyfile data file a (recfgm £ lrecl 130 
converts the file DATA FILE A1 to fixed-length 130-character records. 
If you specify an output fileid, for example: 
copyfile data file a fixdata file a (recfm f lrecl 130 


the original file remains unchanged. The file FIXDATA FILE A contains 
the converted records. 


If the records ina file being copied are variable-length, each 
output record is padded with blanks to the specified record length. If 
any records are longer than the record length, they are truncated. 


When you convert files from fixed-length records to variable-length 
records, you can specify the TRUNC option to ensure that all trailing 
blanks are truncated: 


copyfile data file a (recfm v trunc 


If you specify the LRECL option and RECFM V, the LRECL option is 
ignored and the output record length is taken from the longest record in 
the input file. 


When you convert a file from variable-length to fixed-length records, 
you may also specify a fill character to be used for padding instead of 
a blank. If you specify: 


copyfile short recs a (recfm f fill * 


then each record in the file SHORT RECS is padded with asterisks to the 
record length. Assuming that SHORT RECS was originally a 
variable-length file, the record length is taken from the longest 
existing record. Note that if SHORT RECS is already fixed-length, it is 
not altered. 


Similarly, when you are converting back to variable-length a file 
that was padded with a character other than a blank, you must specify 
the FILL option to indicate the fad character, so that character is 
truncated. 


The FILL option can also be used to specify the packing character 
used with the PACK opticn. When you use the PACK option, a file is 
compressed as follows: all occurrences of two or more blanks are 
encoded as one character, and four or more occurrences of any other 
character are written as three characters. If you use the FILL option 
to specify a fill character, then that character is treated as a blank 
when records are compressed. You must, of course, specify the FILL 
option to unpack any files packed in this way. Since most fixed-length 
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files are blank-padded to the record length, you do not need to specify 
the FILL option unless you know that some other character appears nore 
frequently. 


A file which is packed on an 800 byte blocksize disk will be fixed 
format file with a logical record length of 800. On a 1K, 2K, or 4K 
blocksize disk, the file will be fixed format with a logical record 
length of 1024. A packed file of either logical record length can be 
unpacked back to its original specifications regardless of the disk 
blocksize it resides on. A packed file with logical record length 800 
on a disk with blocksize 1K, 2K, or 4K, and packed files with logical 
record length 1024 on 800 byte disks should be unpacked and re-packed if 
minimal disk block usage is needed. 


When you convert record formats on packed files with the COPYFILE 


command you can specify single or nultiple output files, in accordance 
with the procedures outlined under “Modifying Record Formats." For 


example: 
copyfile * assemble a (pack 


compresses all ASSEMBLE files in the A-disk without changing any file 
identifiers. The command: 


copyfile * assemble a = script = (recfm trunc 


converts all ASSEMBLE files to variable-length, and changes’ their 
filetypes to SCRIPT. 


Entering a COPYFILE Specification List 


When you use the COPYFILE command, you can specify particular columns of 
data to be manipulated or particular characters to be translated. 
Again, how you specify the file identifier determines how many files are 
copied or modified. 


When you use the SPECS option on the COPYFILE command, you receive 
the message: 


DMSCPY601R ENTER SPECIFICATION LIST: 
CP waits for you to enter a specification list. If you do not wish to 
receive this message, use the NOPROMPT option. The specification list 


you enter may consist of one or more pairs of operands in the following 
format: 


nn-nn 
jeering/| col 


be > Gere 


nbnh-gm specifies the start and end columns of the input file that are to 
be copied to the outrut file. If mm exceeds the length of the 
input record, the end of the record is the assumed ending 
position. 


string is any string of uppercase and lowercase characters or numbers 
delimited by any non-alphameric character. 


hxx... is an even number of hexadecimal digits prefixed with an h. 


col is the column in the output file at which the copy operation is 
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to begin. 


You can enter as many as 20 pairs of specifications. If you want to 
enter more than one line of specifications, enter two plus Signs (++) at 
the end of one input line as continuation indicators. 


A specification list may contain any combination of specification 
pairs; for example: 


copyfile sorted list a (specs 
DMSCPY601R ENTER SPECIFICATION LIST: 
4\/f 11-8 3 Sif 12 /s¥**S 14 +4 

9-80 18 


After this command is executed, each record in the file SORTED LIST 
will look like the following: 


| oO0000000 | *** QO000.... 


where the o's in columns 3 through 10 indicate information originally in 
columns 1 through 8; the o's following the asterisks indicate the 
remainder of each record, columns 9 through 80. 


When you enter a specification list, you are actually constructing a 
file column by column. If you specify multiple infut or output files, 
the same copy operation is performed for each record in each output 
file. 


Those columns for which you do not specify any data are filled with 
blanks or, if you use the FILL option, the fill character of your 
choice. For example: 


copyfile sorted list a (specs nofrompt lrecl 20 fill $ 
1-15 6 


copies columns 1 through 15 beginning in column 6 and writes dollar 
signs($)in columns 1 through 5. . 


If you do want to modify data in particular columns of a_ file but 
want to leave all of the rest of each record unchanged, you can use the 
OVLY (overlay) option. Fcr example, the sequence: 


COPYFILE * bracket a (specs ovly noprompt 
had 1 hbd 80 


overlays the characters [ (X'AD') and } (X'BD*') in columns 1 and 80 of 
all the files with a filetype of BRACKET on your A-disk. 


When you copy fixed-length files, records are padded or truncated to 
the record length; variable-length files are always written as 
specified. 


Entering Translation Specifications 


You can perform conversion on particular characters in CMS files or 
groups of files with the TRANS option of the COPYFILE command. 


When you enter the TRANS option, you receive the message: 
DMSCPY602R ENTER TRANSLATICN LIST: 
and a read is presented to your virtual machine. You may enter the 


translation list. If you do not wish to receive this message, use the 
NOPROMPT option. 
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A translation list consists of one or more pairs of characters or hex 
digits, each pair representing the character you want to translate and 
the character you want to translate it to, respectively. For example: 


copy test file a (trans 

DMSCPY602R ENTER TRANSLATION LIST: 

* - A £0 00 ff 
specifies that all occurrences of the character * are to be translated 
to -, all character A's are to be translated to X'FO" and all X'00'sS are 
to be translated to X'FF's. 

If any translation specifications you enter conflict with the 

LOWCASE, EBCDIC, or UPCASE options specified on the same command line, 
the translation list takes precedence. In the preceding example, if 


LOWCASE had also been specified, all A's would be translated to X'FO's, 
not to a's. 


You can enter translation pairs on more than one line if you enter a 
++ as a continuation indicator. 
Responses 
DMSCPY601R ENTER SPECIFICATION LIST: 


This message prompts you to enter a specification list when you use 
the SPECS option. 


DMSCPY602R ENTER TRANSIATICN LIST: 


This message prompts you to enter a translation list when you use 
the TRANS option. 


DMSCPY721I COPY ‘fn £t fm" [TO | APPEND| OVLY) ‘fn £t f£m* [OLD] NEW) FILE 


This message appears for each file copied with the TYPE option. It 


indicates the names of the input file and output file. When you 
have multiple input files, the output fileid is displayed only 
once. 


Other Messages and Return Codes 


DMSCPYOO2E {INPUT|OVERLAY} FILE ‘fn ft f£m' NOT FOUND RC=28 
DMSCPYOO3E INVALID OPTION ‘option' RC=24 


DMSCPYO24E FILE ‘fn ft fm' ALREADY EXISTS -- SPECIFY "REPLACE* RC=28 
DMSCPYO29E INVALID PARAMETER ‘parameter' IN THE OPTION ‘option! FIELD 
RC=24 


DMSCPYO30E FILE 'fn ft fm* ALREADY ACTIVE kC=28 

DMSCPYO37E DISK ‘mode* IS READ/ONLY RC=36 

DMSCPYO42E NO FILEID(S) SPECIFIED kRC=24 

DMSCPYOUSE INVALID MODE 'mode* RC=24 

DMSCPYOS4YE INCOMPLETE FILEID ‘fn [f£t'] SPECIFIED RC=24 

DMSCPYO62E INVALID CHAR '[=|*|char]* IN FILEID '[fn ft fm]* RC=20 

DMSCPYO63E NO {TRANSLATION|SPECIFICATION} LIST ENTERED RC=40 

DMSCPYO64E INVALID [TRANSLATE] SPECIFICATION AT OR NEAR ‘..2--.-.! 
RC=24 

DMSCPYO65E ‘option! OPTION SPECIFIED TWICE RC=24 

DMSCPYO66E ‘option AND ‘option! ARE CONFLICTING OPTIONS RC=24 

DMSCPYO67E COMBINED INPUT FILES ILLEGAL WITH PACK OR UNPACK OPTIONS 
RC=24 

DMSCPYO68E INPUT FILE ‘fn f£t fm' NOT IN PACKED FORMAT RC=32 

DMSCPYO69E DISK 'mode* NOT ACCESSED RC=36 

DMSCPY101S "SPECS TEMP STRING STORAGE EXHAUSTED AT *....-.-.' RC=88 
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DMSCPY102S 
DMSCPY103S 
DMSCPY156E 


DMSCPY157E 
DMSCPY172E 


DMSCPY173E 
DMSCPY901T 


DMSCPY903T 
DSSCPYSOUT 


COPYFILE 


TOO MANY FILEFIDS Rc=88 

NUMBER OF SPECS EXCEEDS MAX 20 RC=88 

"FROM nnon* NOT FOUND --FILE ‘fn ft fm* HAS ONLY 'nuon* RECORDS 
RC=32 

LABEL 'label' NOT FOUND IN FILE ‘fn ft fp" RC=32 

TO LABEL 'label' {EQUALS| IS AN INITIAL SUBSTRING OF} FRLABEL 
‘label’ RC=24 

NO RECORDS WERE COPIED TO OUTPUT FILE ‘fn ft fm*' RC=40 
UNEXPECTED ERROR AT ‘addr': PLIST 'plist* AT *addr', BASE 
‘addr', RC 'nn* RC=256 

IMPOSSIBLE PHASE CODE 'xx' RC=256 

UNEXPECTED UNPACK ERROR AT ‘addr', BASE ‘addr'* RC=256 
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Use the CP command to transmit commands to the VM/SP control program 
environment without leaving the CMS environment. The format of the CP 
command is: 


a a a a aS aa i aaa ae 
| CP i  [ commandline ] | 
ha ee . eee ed 
where: 

commandline 


is any CP command valid for your CP command privilege class. 
If this field is omitted, you are placed in the CP environment 
and may enter CP commands without preceding each command with 
CP. To return to CMS, issue the CP command BEGIN. 
Usage Notes 
1. You must use the CP command to invoke a CP command: 


e Within an EXEC procedure 


e If the implied CP (IMPCP) function is set to OFF for your 
virtual machine 


e Ina job you send to the CMS tatch facility 


2. To enter a CP command from the CMS environment without CMS 
processing the command line, use #CP. 


3. When you enter an invalid CP command following the CP command, you 
receive a return code of —1. In an EXEC, this return code is +1. 


Responses 


All responses are from the CP command that was issued; the CMS ready 
message follows the response. 
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DDR 


Use the DASD Dump Restore (DDR) program to dump, restore, copy, or print 
VM/SP user minidisks. The DDR frogram may run as a standalone progran, 
or under CMS via the DDR command. 


The DDR program has five functions: 

1. Dumps part or all of the data from a DASD device to tape. 

2. Transfers data from tapes created by the DDR dump function toa 
direct access device. The direct access device must be the same as 
that which originally contained the data. 

3. Copies data from one device to another of the same type. Data may 
te reordered, by cylinder or by block for fixed-block DASD, when 
copied from disk to disk. In order to copy one tape to another, 
the original tape must have been created by the DDR DUMP function. 


4. Prints selected parts of DASD and tape records in hexadecimal and 
EBCDIC on the virtual printer. 


5. Displays selected parts of DASD and tape records in hexadecimal and 
EBCDIC on the terminal. 


The format of the DDR command is: 


1 4e Fh 
5B 

a One | 
_) 


r a | 
fn ft |fol 
[* | 
L Jj 
identifies the file ccntaining the control statements for the 
DDR program. If no file identification is provided, the DDR 
program attempts to obtain control statements from the 
console, The filemode defaults to * if a value is not 
provided. 


Usage Notes 


1. If you use the CMS DDR command, CMS ignores the SYSPRINT control 
statement and directs the output to the CMS printer OOE. 


2 Be aware that DDR, when run as a standalone program, does not have 
error recovery support. However, when DDR is invoked in CMS, ina 
virtual machine environment, the I/O operation is performed by CP; 
CP has better error recovery facilities. 


36 When running aS a standalone program, DDR searches for a console at 


address 009 or O1F. If there is no operational console at one of 
these addresses, the program enters a wait state until an interrupt 
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occurs to identify the address of the console. If any nonconsole 
device is physically connected to address 009 or O1F, it must be 
disconnected or results are unpredictable. 


u. When performing the DUMP or COPY functions, the standalone DDR 
utility will not support cylinder faults for MSS virtual volumes. 


5. DDR copies mode zero (private) files from a CMS disk if that disk 
was linked R/O. Use read fasswords to protect private files on CMS 
disks when using ACCESS. 


6. Results are unpredictable if DDR is used to copy data from one 
Minidisk to another minidisk formatted with a different blocksize 
(if the output disk is larger than the input disk). 


DDR CONTROL STATEMENTS 


DDR control statements describe the intended processing and the needed 
I/O devices. Specify I/O definition statements first. 


All control statements may be entered from either the console or the 
card reader. The program inspects only columns 1 to 71. All data after 
the last operand ina statement is ignored. An output tape must have 
the DASD cylinder header records in ascending seguences; therefore, 
enter extents in sequence by DASD location, that is, in sequence by 
cylinder number if count—key-data or ty block number if FB-512. Only 
one type of function — dump, restore, or copy — may be performed in 
one execution, but up to 20 statements describing cylinder or block 
extents may be entered. 


The function statements are delimited by an INPUT or OUTPUT 
statement, or by a null line if the console is used for input. If 
additional functions are to te performed, the seguence of control cards 
must be repeated. If you do not’ use INPUT or OUTPUT control statements 
to separate the functions you specify when the input is read from a card 
reader or CMS file, an error message (DMKDDR702E) is displayed. The 
remainder of the input stream is checked for proper syntax, but no 
further DDR operations are performed. Only those statements needed to 
redefine the I/O devices are necessary for subsequent steps. All other 
I/O definitions remain the same. 


To return to CMS, enter a null line (carriage return) in response to 
the prompting message (ENTER:). To return directly to CP, key in #CP. 


The PRINT and TYPE statements work differently from other DDR control 
statements in that they operate on only one data extent at atime. If 
the input is from a tape created by the dump function, it must be 
positioned at the header record for each step. The PRINT and TYPE 
statements have an implied output of either the console (TYPE) or system 
printer (PRINT). Therefore, PRINT and TYPE statements need not be 
delimited by an INPUT or OUTPUT statement. 


I/O DEFINITION STATEMENTS 


The I/0 definition statements describe the tape, DASD, and printer 
devices used while executing the DASD Dump Restore progran. 
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INPUT/OUTPUT Control Statement 


An INPUT 


or OUTPUT statement describes each tape and DASD unit used. 


The format of the INPUT/OUTPUT statement is: 


cuu 


type 


c m | 
cuu type |volser[{ [ (options...) ] 


[ l 
| : 
[ Jaltape| | 
| . J i 
| Options: l 
| r 1 16 1 | 
| ISKip nn | |MOde 6250 | | REWind| | 
ISKip 0 | [MOde 1600 | |UNload| l 
| t 4 |MOde 800 | |LEave | | 
| L J L J | 


indicates that the device described is an input device. 
indicates that the device described is an output device. 

Note: If the output device is a DASD device and DDR isS running 
under CMS, the device is released using the CMS RELEASE 
command function and DDR processing continues. 


is the unit address of the device. 


is the device tyre: 


2314 3350 2400 
2319 3375 2420 
3330 3380 3410 
3330-11 2305-1 3420 
3340-35 2305-2 8809 
3340-70 FE-512 (FB) 


DDR does not provide 7-track support for any tape devices. 


Specify a 3340-70F as a 3340-70, and a 3333 as a 3330. Specify 
a 3350 that is in 3330-1 or 3330-11 compatibility node asa 
3330 or 3330-11. Specify a 3344 as a 3340-70, and specify 
3350 for a 3350 operating in native mode (as opposed to 
compatibility mode). Note that both 3310 and 3370 are denoted 
by specifying FE-512 or simply FB. 


Note: The DASD Dump Restore (CDR) program, executing in a 
virtual machine, uses I/O DIAGNOSE 20 to perform tI/0 
Operations on tape and DASD devices. DDR under CMS requires 
that the device type entered agree with the device type of the 
real device as recognized by VM/SP. If there is a conflict 
with device types, the follcwing message is issued: 


DMKDDR7O8E INVALID CPTION 


However, if DDR executes standalone ina virtual machine, DDR 
uses DIAGNOSE 20 to perform the I/0 operation if the device 
types agree. If the device types do not agree, error message 
DMKDDR7O8E is issued. 
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volser 


altape 


The speed setting for 8809 tape drives is not under the user's 
control. When DDR is running as a command under CMS, the 8809 
is supported only in start/stop node. If DDR is run 
stand-alone in a virtual machine, DDR attempts to run the 8809 
in high-speed mode. In this mode, the data transfer time is 
reduced. However, this does not mean that the time for a DDR 
job is reduced; job duration defends on pany factors such as 
processor and device contention. 


is the volume serial number of a DASD device. If the keyword 
"SCRATCH" is specified instead of the volume serial number, no 
label verificaticn is performed. 

is the address of an alternate tape drive. 


Note: If multiple reels of tape are required and “altape" is 
not specified, DDR types the following at the end of the reel: 


END OF VOLUME CYL xxx HD xxx, MOUNT NEXT TAPE 


After the new tare is mounted, DDR continues automatically. 


Options: 


SKIP 


MODE 


REWIN 
UNLOA 


LEAVE 


1. When 
displ 
REWIN 

2. If DD 
the d 
the 
displ 


IN 
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nn forward spaces nn files on the tape. nn is any number 
0 up to 255. The SKIP option is reset to zero after the 
tape has been positioned. 


T 1 

[6250] causes all output tapes that are opened for the first 

}1600| time and at the load point to be written or read in 

| 800] the specified density. All subsequent tapes nounted 

L J are also set to the specified density. If no node 
option is specified, then no mode set is performed and 
the density setting remains as it previously was. 


D rewinds the tare at the end of a function. 
D rewinds and unloads the tape at the end of a function. 


leaves the tape positioned at the end of the file at 
the end of a function. 


the wrong input tape is mounted, the message DMKDDR7O9E is 
ayed and the tare will rewind and unload regardless of options 
D, UNLOAD, or LEAVE being specified. 


R is executed from CMS, failure to attach the tape drive or 
isk device (or both) to your virtual machine prior to invoking 
input/output statement causes the following response to be 
ayed: 


VALID INPUT OR OUTFUT DEFINITION 
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SYSPRINT Control Statement 


RS TS a ROD aR — 


The SYSPRINT control statement describes the device that output is to be 
sent to. If the SYSPRINI CONS option is specified, the output is 
directed to the console fcr both the CMS environment and the standalone 
DDR virtual machine. 


In the CMS environment, all output is directed (by default) to OOE, 
unless the SYSPRINT CONS oftion is specified. Any SY¥SPRINT cuu option 
specification is ignored. 


In the standalone DDR virtual machine, the output is directed to the 
output device specified Ey the SYSPRINT cuu option. If the SYSPRINT 
CONS option is specified, all output is directed to the console. If no 
options are specified, the output is directed (Ly default) to OOE. 


where: 
cuu specifies the unit address of the device. 
CONS Specifies the console as the output device. 


Function Statements 


The function statements tell the DDR program what action to perforn. 
The function commands also describe the extents to be dumped, copied, or 
restored. The format of the DUMP/CCPY/RESTORE control statement is: 


[ l r a | 
| DUmp | [FIr]? |Jcyl1 [To] [cyl2 [Reorder] [To] [cy13]] i | 
{ COpy | [| block1 [To] [Elock2 [ Reorder] [To] [ block3]] i | 
[ REstore | | CPvol i | 
i | [ ALL i | 
| | |NUcleus 1 | 
l | : 4 | 


Uae ae ae a a a a an a an a a a ww a wn aw a wn wt = ar a = a a er a a a = eo = ee ee ¥ 
where: 
DUMP requests the program to move data from a direct access volune 


onto a magnetic tape or tapes. The format of the tape depends 
on the type of the direct access volume. The tape format is 
Shown for both count-key-data and FB-512 devices. 
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requests an output tape format of variable unblocked records. 
The size of the records and the number of records’ per track 
written to the tape depend on the density of the tape. The 
option can be used for those devices Supporting the 
full-track-read feature (FTR) (3330, 3340, 3344, 3350, 3375, 
and 3380) and for FB-512 devices. (FTR is the default for 
3375 and 3380 and therefore need not be specified.) 


If FTR is specified on the DUMP control statement for a 
count-key-data (CKD) DASD but the control unit does not 
Support the feature, a message iS written and the operation 
proceeds with data written in the old format. 


For count-key-data DASD, the data 1s noved 
cylinder-by-cylinder. Any number of cylinders can be moved. 
The format of the resulting tape is: 


Record 1: a volume header record, consisting of data 
describing the volumes. 


Record 2: a track header record, consisting of a list of count 
fields to restore the track, and the number of data records 
written on tape. After the last count field the record 
contains key and data records to fill the 4K buffer. 


Record 3: track data records, consisting of key and data 
records packed into 4K blocks, with the last record truncated. 


Record 4: either the end-of-volume (EOV) or end-of-‘job (EOQOJ) 
trailer label. The end-of-volume label contains the same 
information as the next volume header record, except that the 
ID field contains FOV. The end-of-job trailer label contains 
the same information as record 1 except that the cylinder 
number field contains the disk address of the last record on 
tape and the ID field contains EOJ. 


FTR Format 


Record 1and Record 4 are the same as described for the 
non-FTR format. 


Record 2: a track header record, consisting of fields 
containing the length of the track, the density of the tape, 
and the number of count fields in the track followed by the 
track contents. 


Record 3: track data records, consisting of count-key-data 
records in 8K, 12K, or 49K blocks for 800, 1600, or 6250 BPI 
respectively, with the last block being a short block. 


For FB-512 devices, the data is moved in ‘sets' of blocks. 
Each set contains 95 blocks of data. (The last set moved may 
have less than 95 blocks.) Any number of blocks can be moved 
with one DUMP statement. The format of the resulting tape 
depends on the density of the output tape and whether or not 
the FTR option is specified. 


Record 1: a volume header record, consisting of data 
describing the volume. 


Record 2: a data header record. This consists of control data 


that describes the set of blocks that follow (Such as block 
numbers and the number of tape records required to hold these 
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FB-512 blocks). Following the control data is the actual 
FB-512 blocks filling out the tape record. 


Record 3: FB-512 data records. These contain the rest of the 


blocks making up the set. 


Record 4: either the end-of-volume (EOV) or end-of-job (EQOJ) 
trailer label. The EOV label contains the same information as 
the next header record, except that the ID field contains EOV. 
The EOJ trailer label is just like record 1 except that it 
contains the number of the last DASD block dumped and the ID 
field contains EOJ. 


In non-FTR format, the record length of record 2 and of record 
3 is 4K bytes. For FIR formatted tapes, the record length is 
8K, 12K, or 49K bytes for 800, 1600, 6250 BPI respectively, 
with the last block being a short one. 


requests the program to copy data from one device to another 
device of the same or equivalent type. Note that you cannot 
copy between FB-512 and count-key-data DASD. Data may be 
recorded on a cylinder or block basis from input device to 
output device. A tape-to-tape copy can be accomplished only 
With data dumped by this progran. 


requests the program to return data that has been dumped by 
this program. Data can ke restored only to a DASD volume of 
the same or equivalent device type from which it was dumped. 
It is possible to dump from a real disk and restore to a 
Minidisk as long as the device types are the same. 


[cy1l2 [REORDER] [TO] [cy13]] 

Only those cylinders specified are moved, starting with the 
first track of the first cylinder (cyl1), and ending with the 
last track of the second cylinder (cy12). The REORDER operand 
causes the output to ke reordered, that is, moved to different 
cylinders, starting at the specified cylinder (cyl3) or at the 
Starting cylinder (cyl1) if cyl3 is not specified. The 
REORDER operand must not be specified unless specified limits 
acre defined for the operation; the starting and, if required, 
ending cylinders (cyl1 and cyl2) must be specified. Note that 
if the input device cylinder extents exceed the number of 
cylinders specified on the output device, an error message 
results. 


block1 [To] [block2 [Reorder] [To] [block3]] 


CPVOL 


ALL 


Only those blocks specified are moved, starting with the block 
indicated by block1, up to and including the block indicated 
by block2. The REORDER operand causes the data to be moved to 
a different DASD location. The REORDER operand must not be 
specified unless Specified limits are defined for the 
Operation. If the input Flock extents exceed the capacity of 
the output device, an error message results. 


specifies that cylinder 0 (blocks 0-15 if FB-512) and all 
active directory and permanent disk space are to be copied, 
dumped, oor restored. This indicates that both source and 
target disk must be in CP format; that is, the CP 
Format/Allocate program must have formatted then. 


specifies that the operation is to be performed on the entire 
DASD volume (all cylinders or all blocks). 
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Note: The occurrence of message DMKDDR705E (issued upon 
completion of the copy, restore, or dump operation) indicates 
that an attempt was made to copy, restore, or dump the 
contents of DASD locations beyond the extents of the 
designated minidisk. 


NUCLEUS specifies that record 2 on cylinder 0, track 0 (blocks 5-12 if 
FB-512) and the nucleus are dumped, copied, or restored. 


Restrictions (for other than FB-512): 
e Each track must contain a valid home address, containing the real 
cylinder and track location. 


e Record zero must not contain more than eight key and/or data 
Characters. 


e Flagged tracks are treated just as any other track for all 2314, 
2319, 3340, and 2305 devices. That is, no attempt is made to 
substitute the alternate track data when a defective primary track is 
read. In addition, tracks are not inspected to determine whether 
they were previously flagged when written. Therefore, volumes 
containing flagged tracks should be restored to the same cylinders of 
the volume from which they were dumped. The message DMKDDR715E occurs 
each time a defective track is dumped, copied or restored, and the 
Operation continues. 


e Flagged tracks on 3330, and 3350 devices are handled automaticaily by 
the control unit and may never te detected by the progran. The 
program may detect a flagged track if, for example, no alternate 
track is assigned to the defective primary track. If a flagged track 
is detected by the program, the message DMKDDR715E occurs’ and the 
Operation terminates. 


e For DASD devices other than the 3375 and 3380 that support the full 
track read (FTR) processing, the option must be specified. 
Otherwise, the tape is produced in the current DDR format of 4096 
blocks. The 3330/3340 DASD devices can only take advantage of the 
full track read feature when the 3830 has microcode supporting either 
the 3344 or 3350. 


Example: 


INPUT 191 3330 SYSRES 

OUTPUT 180 2400 181 (MCDE 800 
SYSPRINT OOF 

DUMP CPVOL 

INPUT 130 3330 MINIO1 

DUMP 1 TO 50 REORDER 51 

60 70 101 


This example sets the density to 800 bpi, then dumps all pertinent 
data from the volume labeled SYSRES onto the tape that is mounted on 
unit 180. If the program runs out of space on the first tape, it 
continues dumping onto the alternate device (181). A map of the dumped 
cylinders is printed on unit OOF while the program is dumping. When the 
first function is complete, the volume labeled MINIO1 is dumped onto a 
new tape. Its cylinder header records are labeled 51 to 100. A map of 
the dumped cylinders is fprinted on unit OOF. Next, cylinders 60 to 70 
are dumped and labeled 101 to 111. This extent is added to the cylinder 
Map on unit OOF. When the DDR processing is complete, the tapes are 
unloaded and the program stofs. 
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If cylinder extents are being defined from the console, the user need 
only enter DUMP, COPY or RESTORE on the command line. The following is 
displayed: 


ENTER CYLINDER EXTENTS 
ENTER: 


For any extent after the first extent, the message: 


ENTER NEXT EXTENT OR NULL LINE 
ENTER: 


is displayed. 


You may then enter additional extents to be dumped, restored, or 
copied. A null line causes the job step to start. 


Notes: 


1. When a cylinder map is printed on the virtual printer (OOF as in 
the previous example) a heading precedes the map information. 
Module DMKDDR controls the disk, time and zone printed in the 
heading. Your installation must apply a local modification to 
DMKDDR to ensure that local time, rather than GMI (Greenwich 
Meridian Time), is printed in the heading. 


2. Attempts to restore cylinders or blocks beyond the capacity that 
had been recorded on the tape froduces a successful EOJ, but the 
printout only indicates the last cylinder or block found on the 
tape. 


Use the PRINT and TYPE function statement to print or type (display) a 
hexadecimal and EBCDIC translation of each record specified. The input 
device must be defined as direct access disk. The output is directed to 
the system console for the TYPE function, or to the SYSPRINT device for 
the PRINT function. (This does not cause redefinition of the output unit 
definition.) The format of the PRINT/TYPE control statement is: 


| PRint [I[cy11 [hh1 [rr1]] {To cyl2 [hh2 [rr2 ]]] [ (options...[) JJ]I 
| TYpe [[ block1 [To block2] jl 
| | | 
| l options: | 
; | [Hex] [Graphic] [Count] | 
Mn a a ee ed 
where: 

cyl1 is the starting cylinder. 

hh1 is the starting track. If present, it must follow’ the cyl1 

operand. The default is track zero. 
rr is the starting record. If present, it must follow the hht 


operand. The default is home address and record zero. 


TO cyl2 is the ending cylinder. If more than one cylinder is to be 
printed or typed, "TO cyl2" must ke specified. 
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hh2 is the ending track. If present, it must follow the cyl2 
operand. The default is the last track on the _ ending 
cylinder. 

rr2 is the record ID of the last record to print. The default is 


the last record on the ending track. 
block1 is the starting FB-512 block number. 


To block2 is the ending block number. If more than one block is to be 
printed or typed, 'To block2' must be specified. 


Options: 

HEX prints or displays a hexadecimal representation of each record 
specified. 

GRAPHIC 
prints or displays an EBCDIC translation of each record 
specified. 


COUNT prints or displays only the count field for each record 
specified. This option is ignored for FB-512 data. 


Usage 


If the TYPE statement follows the occurrence of error message DMKDDR705E 
and specifies the same cylinder, track, and record extents indicated in 
the error message, the contents of the printed record must be 
interpreted in the context of the I/O error information given in the 
initial message. 


Examples 
PRINT 0 TO 3 

Prints all of the records from cylinders or blocks 0, 1, 2, and 3. 
PRINT 0 1 3 

Prints only one record, from cylinder 0, track 1, record 3. 
PRINT 1103 TO 115 4 


Prints all records starting with cylinder 1, track 10, record 3, and 
ending with cylinder 1, track 15, record 4. 


The example in Figure 7 shows the information displayed at’ the 
console (TYPE function) cr system printer (PRINT function) by the DDR 
program. The listing is annotated to describe some of the data fields. 

The printed output for FB-512 data is self-explanatory. DDR prints a 


short heading telling the block numker, then prints the 512 bytes of 
data in that block. 


Responses 


DMKDDR711R VOLID READ IS volid2 [NOT volid1] 
DO YOU WISH TC CONTINUE? RESPOND YES NO OR REREAD: 


where: 
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volid2 is the volume serial number from the VOL1 label on the 
DASD unit. 
volidt1 is the volume serial number from the INPUT or OUTPUT 


control card. 
The volume serial number read from the device at cuu is'7 not the 
same as that specified on the INPUT or OUTPUT control card. 
DMKDDR716R NO VOL1 LABEL FOUND FOR volser 
DO YOU WISH TC CONTINUE? RESPOND YES NO OR REREAD: 


where: 


volser is the volume serial number of the DASD device from the 
INPUT or the OUTPUT control card. 


The DASD device at cuu contains no volume serial number. 


DMKDDR717R DATA DUMPED FROM volid1 TO BE RESTORED TO volid2 
DO YOU WISH TO CONTINUE? RESPOND YES NO OR REREAD: 


where: 

volid1 is the volume serial number from the input tape header 
record (volume dumred). 

volid2 is the volume serial number from the output DASD device. 


The above message is printed to verify the input parameters. 


ENTER CYLINDER EXTENTS OL ENTER BLOCK EXTENTS 
ENTER: ENTER: 


This message 1s received only if you are entering input from your 
terminal. 


END OF VOLUME CYL xxx HD xx, MOUNT NEXT TAPE 
or END OF BLOCK xxxxxxxx, MOUNT NEXT TAPE 


DDR continues processing, after the mounting of the next tape reel. 
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Home Address 
Record 0 


Cylinder and head Home Address of track Record 0 1D from the Key | Data Data 
identification for in hexadecimal format count field Len | Length (hexadecimal) ] 
Record 0 (hexadecimal) 


| @ A heading is printed containing the 

Cylinder, head, and Record ID data length from the count field first in | 

record numbers in (hexadecimal) ; decimal, then in hexadecimal 

decimal (hexadecimal) | @ The data is then printed in hexadecimal 
with graphic interpretation at the right 
(not shown here). 


Record | 


04096 1000 DATA LENGTH 


00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE 


Ist Half of CYL 019 HD 00 REC 002 COUNT 0013000002 00|09A8 Note. Data Length field repeated 
Record 2 in heading. 
02472 DATA LENGTH 


00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE 


ABOVE RECORD WRITTEN USING RECORD OVERFLOW © 


e 
{9 This statement indicates that this portion 
of Record 2 was written using the Write | 
Special Count, Key, and Data command. The 
remainder of Record 2 is found on the next | 
track as the first record after Record 0. 


—— | 
Home Address CYL 019 HD 01 HOME ADDRESS 0000130001 RECORD ZERO 0013000100 00 0008 00000000 00000000 
Record 0 


2nd Half of 
Record 2 01624 0658 DATA LENGTH 


CYL 019 HD 01 REC 002 COUNT 0013000102 00 0658 


00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE .. 


If the key length field is not zero 


@ A heading is printed containing the key length 
first in decimal, then in hexadecimal. 
@ The key is then printed in hexadecimal with 
graphic interpretation at the right (not shown mee) 


Record 3 CYL 019 HD 01 REC 003 COUNT 0013000103 80 OF80 
00128 0080 KEY LENGTH 


00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE ... 


03968 O0F80 DATA LENGTH 


00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE ... 


Record 4 CYL 019 HD 01 REC 004 COUNT 0013000104 00 0000 © 


END OF FILE i re 


Whenever the data length field is zero 
an end-of-file prints next. 


| 


Figure 7. An Annotated Sample of Output from the TYPE and PRINT 
Functions of the DDR Program 
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RESTORING volser 


where: 
volser is the volume serial number of the disk dumped. 


The RESTORE operation has begun. 


COPYING volser 


where: 
volser is the volume serial number described by the input unit. 


The COPY operation has begun. 


DUMPING volser 


where: 
volser is the volume serial number described by the input unit. 


The DUMP operation has begun. 


PRINTING volser 


END 


END 


END 


END 


END 


where: 
volser is the volume serial number described by the input unit. 


The PRINT operation has begun. 


OF DUMP 


The DUMP operation has ended. 


OF RESTORE 


The RESTORE operation has ended. 


OF COPY 


The COPY operation has ended. 


OF PRINT 


The PRINT operation has ended. 


OF JOB 


All specified operations have completed. 
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DDR 


ENTER: 


Prompts 
pressing the Enter 


for input from the terminal. A null line (that is, 


key or equivalent) causes control to return to 


CMS if the virtual machine is in the CMS environment. 


DMKDDR725R 


ORIGINAL INPUT DEVICE WAS(IS) 
DO YOU WISH TO CONTINUE? 


LARGER THAN 
RESPONSE YES CR NOs 


OUTPUT DEVICE. 


Explanation: 


RESTORE 
original DASD input unit is compared 


function - The number of cylinders or blocks on the 


with the number on the output 


device. 


COPY function - The input device 


contains more cylinders or blocks 


than the output device. 
Operator Action: The operator must determine if the COPY or RESTORE 
function is to continue. ‘The response is either yes or no. 


Other Messages and Return Codes 


Note: 
a specific 


DMKDDR7TOOE 
DMKDDR701E 
DMKDDR702E 
DMKDDR703E 
DMKDDR7OUE 
DMKDDR7O5E 


DMKDDR7O7E 
DMKDDR708E 
DMKDDR709E 
DMKDDR710A 
DMKDDR712E 
DMKDDR713E 
DMKDDR714E 
DMKDDR715E 
DMKDDR718E 
DMKDDR719E 
DMKDDR720E 
DMKDDR721E 
DMKDDR/22E 
DMKDDR723E 
DMKDDR/24E 
DMKDDR756E 
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Except 
following messages. 


is no return code returned for the 
devices, DASD locations are described by 
of Ly cchhr. 


as shown, there 
For FB-512 
block number instead 


INPUT UNIT IS NOT A CPVOL 
INVALID OPERAND - operand 
CONTROL STATEMENT SECUENCE ERROR 
OPERAND MISSING 

DEV cuu NOT OPERATIONAL 
IO ERROR cuu CSW csw 
bbcchh| block CCW ccw 
MACHINE CHECK RUN SEREP AND SAVE OUTPUT FOR CE 
INVALID INPUT OR OUTPUT DEFINITION 

WRONG INPUT TAPE MOUNTED 

DEV cuu INTERVENTION REQUIRED 

NUMBER OF EXTENTS EXCEEDS 20 

OVERLAPPING OR INVALID EXTENTS 

RECORD bbcchhjblock NOT FOUND ON TAPE 

LOCATION kEbcchh|btlock IS A FLAGGED TRACK RC=3 
OUTPUT UNIT IS FILE FROTFCTED RC=1 
INVALID FILENAME OR FILE NCT FOUND 

ERROR IN routine RC=varies 

RECORD cchhr|block NOT FCUND 

OUTPUT UNIT NCT PROPERLY FCRMATTED FOR THE 
NO VALID CP NUCLEUS ON THE INPUT UNIT 
INPUT TAPE CONTAINS A CP NUCLEUS DUMP 
PROGRAM CHECK PSW=psw 


SENSE sense INPUT bbcchh|jblock OUTPUT 


CP NUCLEUS 
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Use the DEBUG command to enter the debug envircnment from the CMS 
environment. In the debug environment you can use a variety of DEBUG 
subcommands that allow you to test and debug your programs. The DEBUG 
Subcommands are described in "Section 4. DEBUG Subcommands." For 
tutorial information, including examples, see the VM/SP CMS User's 
Guide. The format of the DEBUG command is: 


Usage Notes 
1. The debug environment is also entered as a result of an external 
interruption or _ the result of a breakpoint (address stop) 
encotntered during program execution. 


2. Once you are in the debug environment, you can enter only DEBUG 
subcommands and CP commands via the #CP function. 


3. To return to the CMS environment, enter the DEBUG subcommand 
RETURN. 


Responses 
DMSDBG728I DEBUG ENTERED 


This message indicates that you are in the dekug environment. 
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DEFAULTS 


Use the DEFAULTS EXEC procedure to set up default options for the 
commands that are listed below. Each time you enter one of these 
commands, the options specified in the DEFAULTS command are in effect. 
However, the options specified with each invocation of the various 
commands override the ones set up in the DEFAULTS command. Thus, you 
can customize the options Fy using DEFAULTS, yet override them when you 
desire. DEFAULTS can also be used to display the current default 
options for one or more of the commands. 


The format of the DEFAULTS command is: 


d i r 1 
| DEFAULTS | |Set command options... | 
| | [list [command] | 
| | L J 


where: 

Set specifies that default options are to be set up for the 
command indicated. 

List specifies that the current default options for the command 


indicated are to be displayed. If no command is specified, 
all the commands listed below and their current default 
options are displayed. 


command is one of the commands listed below. 


options is one or more options associated with a particular command, 
as shown below. 


The commands and their options that can be specified as defaults are 
listed below. Valid abbreviations for both the command names’ and the 
keyword options are indicated by uppercase letters. Mutually exclusive 
options are listed one under the other. 


Command Name Options 
Filelist Profile fn Filelist 
Profile PROFFLST NOFilelist 
Note Profile fn Short LOG NOAck NOTebook fn 
Profile PROFNOTE LONg NOLog Ack NOTebook ALL 
NOTebook * 
NONotebook 
Sendfile|Sfile New NOType NOFilelist Log NOAck 
Old Type Filelist NOLoOg Ack 
RDrlist|RList Profile fn 


Profile PROFRLST 


Peek Profile fn FRom recno FOr numrec 
Profile PROFPEEK 


Receive Log Olddate NOTebook fn 


NOLOg NEwdate NOTebook ALL 
NOTebook * 
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Usage Notes 


The DEFAULTS command uses the GLOBALV command, which maintains a LASTING 
GLOBALV file on your A-disk. This file contains the options specified 
in a DEFAULTS command. However, do not edit the LASTING GLOBALV file to 
Change the options. Use the DEFAULTS command, instead. For more 
information on GLOBALV files, see the description of the GLOBALV 
command. 


Responses 


The following is a list of your default options for the ‘command' 
colmand: 
option... 


To change these default options enter ‘DEFAULTS Set command opt! 
<opt2..>!'. 


The following default options have been set: 
commandnane option... 


To change any default options enter ‘DEFAULTS Set cmdname opt! 
<opt2..>'. 


Error Messages and Return Codes 


DMSWDFO1KE INVALID KEYWORD ‘function'. RC=24 

DHSWDFO29E INVALID PARAMETER ‘parm' IN THE CPTION ‘option! FIELD. 
RC=24 

DMSWDF637E MISSING VALUE FOR THE {PROFILE| FROM| FOR | NOTEBOOK} 
OPTION. RC=24 

DMSWDF641E NO {options|command} SPECIFIED. RC=24 

DMSWDF642E DEFAULTS DOES NOT ACCEPT {"COMMAND! command|*OPTION' 
OPTION FOR "CCMMAND'}. RC=24 

DMSWDF653E ERROR EXECUTING "GLOBALV', RC = now RC=40 

DMSSTTO62E INVALID CHARACTER ‘character! IN FILEID ‘fn ft fm'. RC=20 
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Use the DESBUF command to clear the console and program stack input and 
output buffers. The format of the DESBUF command is: 


a Gee Te Re a eS TS eS ee ee ee 
| DESBUF | | 


a a a ee ed 
Usage Notes 

Note that DESBUF clears the output Luffers as well as the input buffers. 
Use the CONWAIT command tefore DESBUF to halt program execution until 
all output lines are displayed at the terminal. 

Warning: Be careful when using the DESBUF command because the input and 


output console and program stack Ltuffers are used to communicate 
information between programs. 
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DISK 
DISK 


Use the DISK command to: 


e Punch CMS disk files to the virtual spooled card punch in a special 
format which allows the punched deck to be restored to disk in the 
form of the original disk file. 


e Restore punched decks created by the DISK DUMP command to a disk 
file. 


The format of the DISK command is: 


a ee ee a OE ERE See OE ee Le a eee ea 
| DISK | \DUMP fn ft [fn] r 
| )LOAD [ ( OLDDate [) ]] | 


Se a a ee a a a ne ee 


where: 


DUMP fn ft fm 
punches the specified file (fn ft fm). The file may have 
either fixed- or variable-length records. After all data is 
punched, an end-of-file card is created with an N in column 5. 
This card contains directory information and must remain in 
the deck. The original disk file is retained. 


LOAD loads a file or files from the spooled card reader and writes 
them as CMS files on your A-disk. The filename and filetype 
are obtained from the card strean. If a file exists with the 


Same filename and filetype as one of those in the card strean, 
it is replaced. 


The card-image sequence numbers on all files being loaded 
are checked. A message notifies the user of any record 
numbers missing or out of order. The file is loaded whether 
or not a problem is found in the seguence number check. 


The DISK LCAD function checks for invalid characters in the 
fileid field of the reader file to be loaded. If an invalid 
Character is found, message DMSDSK496S is printed at the 
console informing the user that the fileid of the reader file 
has been altered. The file is left in the reader. A file is 
not loaded when the last card of the reader file does not 
match the filename, filetype, and filemode of the first card 
in the reader file. 


Note: DISK LOAD file identifiers are those of the specified 
file issued by the DISK DUMP command. 


OLDDATE is an option of the LOAD parameter. When specified, OLDDATE 
retains the date and time of the most recent update of the 
file prior to it being sent to your virtual reader. This date 
becomes the creation date for the _ file being loaded. 
Otherwise, the date and time of execution of the DISK LOAD 
command will be used as the creation date for the output file 
produced by the DISK LOAD. 


Usage Notes 


1. To read files with the DISK LOAD command, they must have been 
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created by the DISK DUMP command. To identify the proper method to 
use in loading spooled reader files, use the ‘RDR*' command. Also 
see the "RECEIVE command. 


2. To load reader files created by DISK DUMP, you must issue the DISK 
LOAD command for each spool file. For example, if you enter: 


disk dump sourcel assemble 
disk dump source2 assemble 


the virtual machine that receives the files must issue the DISK 
LOAD command twice to read the files onto disk. If you use the CP 
SPOOL command to spocl continuous, for example; 


Cp spool punch cont 

disk dump sourcel assemble 

disk dump source2 assemble 

cp spool punch nocont close 


then you only need to issue the DISK LOAD command once to read both 
files. 


3. DISK LOAD loads a file from the reader into a temporary work file 
called ‘DISK CMSUTI1". The existing file with the same name as the 
one being loaded from the reader is then erased. The name of the 
temporary work file just created is changed to the name of the work 
file just read in. If the file you are loading has the name ‘DISK 
CMSUT1"', it is changed to ‘DISK CMSUT2'. ‘'DISK CMSUT1" is a 
reserved work file name for the DISK command. 


4. DISK LOAD or DISK LUME may cause a file to occupy one extra block 
on the disk. If the file is close to filling or exactly fills the 
last block on a 1024, 2048, or 4096 formatted disk, the last record 
produced by the DISK DUMP or DISK LOAD may be filled with X'00's 
causing the file to occupy one extra rElock consisting of X'00's on 
the disk. 


Responses 


There is no response to the DISK DUMP command. The file identifiers of 
each file loaded are disprlayed when you issue the DISK LOAD command: 


fn ft fn 


DMSDSKOO2E FILE ‘fn ft fm' NOT FOUND RC=28 

DMSDSKO14E INVALID FUNCTION ‘function RC=24 

DMSDSKO37E DISK ‘At IS READ/ONLY RC=36 

DMSDSKOA7VE NO FUNCTION SPECIFIEL RC=24 

DMSDSKO48BE INVALID MODE ‘mode* RC=24 

DMSDSKOSH#E INCOMPLETE FILEID SPECIFIED RC=24 

DMSDSKO62E INVALID * IN FILEID ['fn £t fm'] RC=20 
DMSDSKO7OE INVALID PARAMETER ‘parameter’ RC=24 

DMSDSKO77E END CARD MISSING FROM INFUT DECK RC=32 
DMSDSKO78E INVALID CARD IN INPUT DECK RC=32 

DMSDSK104S ERROR 'nn'* REALTING FILE 'fn ft fm" FROM DISK RC=100 
DMSDSK105S ERROR 'nn* WRITING FILE ‘fn ft fm' ON DISK RC=100 
DMSDSK109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 
DMSDSK118S ERROR PUNCHING FILE RC=100 
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DMSDSK1245 
DMSDSK496S 


DMSDSKO78W 
DMSDSK205W 


DMSDSK445wW 
DMSDSK550W 


DISK 


ERROR READING CARD FILE RC=100 

READER FILE ALTERED TO DISK LOAD AS: "fn ft fm*. DISK LOAD 
STOPPED! FILE HAS BEEN LEFT IN YOUR READER. RC=100 

SEQUENCE ERROR DETECTED LOADING ‘fn ft'. EXPECTED '.....' 
FOUND *...2..2'. RC=32 

READER EMPTY CR NOT READY RC=8 

INVALID DATA IN SEQUENCE FIELD, BYPASSING SEQUENCE CHECK. 
DATE/TIME DATA NCT PRESENT FOR FILE ‘fn ft*. 
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DLBL 


Use the DLBL command: 


e In CMS/DOS, to define VSE and CMS sequential disk files for progran 
input/foutput; to identify VSE files and libraries; to define and 
identify VSAM catalogs, clusters, and data spaces; and to identify 
VSAM, VSE, or CMS files used for VSAM program input/output and access 
method services functions. In Many situations, VSE/VSAM does not 
reguire the DLBL command. Information on when a DLBL statement is 
required can be found in the VSE/VSAM Programmer's Reference. 


e In CMS, to define and identify VSAM catalogs, clusters, and data 
Spaces; to identify VSAM files used for program input/output; and to 
identify input/output files for AMSERV. 


The format of the DLBL Command is: 


DLBL [ (optionA optionB [) j]] 


- 
ddname |\node [CMS fn ft 
DUMMY\ {JCMS FILE ddname 

L 


| a | 


. 
| 

| 

| 

| 

| r 1 
[ |DSN gquall [.qual2...qualn] | 
|ddname \mode {|DSN guall [qual2...qualn] | 
| DUMMY\| |DSN ? | 
| L 4 
| 
| 
| 
| 
L 


[ (optionA optionB optionc [) ]] 


ddname CLEAR 


ee | 


* 
optiona: optionB: optionc: 
[ SYSxxx ] [ PER#H ] [VSAM ] 
cr m | r m 
[CHANGE | | EXTENT| 
| NOCHANGE [| [MULT | 
l J l J 


[CAT catdd ] 


[BUFSP nnnoon } 
| ee 


— SS eee eee ei eee ee eee ee Ce eee ee ee Oe ieee ee eee ee 
o=_ See eee eee eee aie ee ee eee eee oe ee eee eee Oe eee ee 
ane oe ee eee ee ee ee eee eee ee ee ee ee eee eee ee eee ee ee ee 


Note: The operands and options of the DLBL ccmmand are described below. 
Usage notes are provided for general usage, followed by additional notes 
for CMS/DOS users, and then additional notes for OS VSAM users. 


where: 

ddnane specifies a one- to seven-character program ddname (OS) or 
filename (VSE), or dname (as specified in the FILE parameter 
of an access method services control statement). An asterisk 
(*) entered with the CLEAR operand indicates that all DLBL 
definitions, except those that are entered with the PERM 
option, are to ke cleared. 

node specifies a valid CMS disk mode letter and optionally, 


filemode number. A letter must be specified; if a number is 
not specified, it defaults to 1. The disk must be accessed 
when the DLBL command is issued. 
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DUM 


CLE 


CMS 


DSN 


J) 


MY 


AR 


fn ft 


OL == 


DLBL 


specifies that no real I/0 is to. be perforned. A read 
Operation results in an end-of-file condition anda write 
operation results in a successful return code. DUMMY should 


not be used for OS VSAM data sets (see Usage Note 3). 


removes any existing definitions for the specified ddname. 
Clearing a ddname before defining it ensures that a file 
definition does not exist and that any options previously 
defined with that ddname no longer have any effect. 


indicates that this is a CMS file, and the file identifier (fn 
ft) that follows is a CMS filename and filetype. 


FILE ddname is the default CMS file identifier associated with 
all non-CMS data sets. (See Usage Note 3 for CMS/DOS users.) 


indicates that this is a non-CMS file. 


indicates that you are going to enter the data set name 
interactively. When prompted, you enter the data set name or 
fileid in its exact form, including embedded blanks, hyphens, 
Or periods. 


quali {.qual2...qualn] 


quali [qual2...qualn|] 


is an OS data Set name or VSE file-id. Only data sets named 
according to standard OS conventions may be entered this way; 
you may omit the periods Letween qualifiers, or specify the 
full dataset name, including periods between gualifiers. (See 
Usage Note 2.) 


Options: 


SYSxxx 


PERM 


CHANGE 


(CMS/DOS only) indicates the system or programmer logical unit 
that is associated with the disk on which the disk file 
resides. The logical unit must have been previously assigned 
with the ASSGN command. In many situations VSE/VSAM does not 
require a SYSxxx operand. Thus no previous ASSGN is required. 
see VSE/VSAM Programmer's Reference for information on when 
the SYSxxx operand is required. 


indicates that this DLBL definition can be cleared only with 
an explicit CLEAR reguest. It will not be cleared when the 
DLBL * CLEAR command line is entered. 


All DLBL definitions, including those entered with the PERM 
option, are cleared as a result of a program abend or HX (halt 
execution) Immediate command. 


indicates that any existing DLBL for this ddname is not to be 
canceled, but that conflicting orftions are to be overridden 
and new options merged into the old definition. Both the 
ddname and the file identifier must be the same in order for 
the definitions to ke merged. 


NOCHANGE 


VSAM 


does not alter any existing DLBL definition for the specified 
ddname, but creates a definition if none existed. 


indicates that the file is a VSAM data set. This option npust 
be specified for VSAM functions unless the EXTENT, MULT, CAT, 
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or BUFSP options are entered or the ddnames IJSYSCT or IJSYSUC 
are used. 


EXTENT 


indicates that you are going to use access methcd services to 
define a VSAM catalog, data space, or unigue cluster and you 
want to enter extent information. 


MULT indicates that you are going to reference an existing 


multivolume data set and you want to enter the volume 
specifications. 


Note: In many situations VSE/VSAM does not require EXTENT or 
MULT informaticn. See VSE/VSAM Programmer's Reference for 
information on when EXTENT or MULT information is required. 


CAT catdd 


identifies the VSAM catalog (defined by a previous DLBL 
definition) which contains the entry for this data set. You 
must use the CAT oftion when the VSAM data set you are 
creating or identifying is not cataloged in the current job 
catalog. catdd is the ddname in the DLBL definition for the 
Catalog. 


BUFSP nnnonnn 


specifies the numker of bytes (in decimal) to be used for I/0 
buffers by VSAM data management during program execution, 
overriding the BUFSP value in the ACB for the file. The 
maximum value for nnnnnon is 999999; embedded commas are not 
permitted. 


Usage Notes 


Vig 
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To display all of the disk file definitions in effect, enter: 
dlbl 
The response will ke: 


ddname DISK fn ft 


If no DLBL definitions are in effect, the following message is 
displayed: 


DMSDLB324I NO USER DEFINED DLBL'S IN EFFECT 


You may enter an OS or VSE file identification on the DLBL command 
line. The maximum length cf the file identification is 44 
characters, including periods. For example, the file 
TEST.-INPUT.SOURCE.D could te identified as follows: 


dlibl dd1 c dsn test input source d (options... 
dlibl dd1 c dsn test.input.source.d (options... 


Or, it may be entered interactively, as follows: 
dlbl dd1i cdsn ? (options 


DHSDLB220R ENTER CATA SET NAME: 
test.input.source.d 
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If the dataset name is entered interactively, the dataset name must 
be entered in its exact form. If it is entered as a command, or 
from EXEC 2, the dataset name may be entered in its exact form. If 
the command is entered with blanks separating the gualifiers, DLBL’° 
replaces them with periods. If it is entered via CMS EXEC, the 
periods between qualifiers must ke omitted, and the qualifiers must 
be 1 to 8 characters long. 


In VSE, a VSAM data set that has been defined as DUMMY is opened 
with an error code of XK'11'. CMS supports the DUMMY operand of the 
DLBL command in the same manner. OS users should not use the DUMMY 
operand in CMS, since a dummy data set does not return, on open, an 
end-of-file indication. 


Do not use the same ddname for a CMS disk if a DLBL already exists 
with the same ddname for a DOS disk. The use of DSN and CMS is not 
interchangeable. 


Each DLBL definition must be associated with a system or programmer 
logical unit assignment, freviously made with an ASSGN command. 
Specify the SYSxxx option on the first, or only, DLBL definition 
for a particular ddname. Many DLBL definitions may be associated 
With the same logical unit. For example: 


assgn sys100 b 

dlbl dd1 b cms test filel (sys100 
dibl dd2 b cms test file2 (sys100 
dlbl dd1 cms test file3 


is a valid command sé€quence. 
In many situations VSE/VSAM does not require the DLBL command. See 
VSE/VSAM Programmer's Reference for information on when the DLBL 


command is required. 


The following special ddnames must be used to define VSE private 
libraries, and must be associated with the indicated logical units: 


Logical 
ddname Unit | Library 
IJSYSSL SYSSLB Source statement 
IJSYSRL SYSRLE Relocatable 
IJSYSCL SYSCLE Core image 


These libraries must be identified in order to perform librarian 
functions (with the SSERV, ESERV, DSERV, or RSERV commands) for 
private libraries; or to link-edit or fetch modules or phases fron 
private relocatable or core image libraries (with the DOSLKED and 
FETCH commands). 


Each VSE file has a CMS file identifier associated with it by 
default; the filename is always FILE and the filetype is always the 
Same as the ddname. For example, if you enter a DLBL command for a 
VSE file MOD.TESTI.STREAM as follows: 

dlbl test c dsn mod.test. stream 


then you can refer to this data set as FILE TEST when you use the 
STATE conmand: 


state file test 
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When you enter a DLBL command specifying only a ddname and mode, as 
follows: 


dlbl junk a 
CMS asSigns a file identifier of FILE JUNK A1 to the ddname JUNK. 


4. The FILEDEF command performs a function similar to that of the DLBL 
command; you need to use the FILEDEF command in CMS/DOS only: 


e When you want to override a default ddname for an assembler 
input or output file. 


e When you want to use the MOVEFILE command to process a file. 


5. If you use the DUMMY operand, you must have issued an ASSGN command 
specifying a device type of IGN, or ignore, for the SY¥Sxxx unit 
specified in the DLBL command, for example, 


assgn sys003 ign 
dlibl test dummy (sys003 


SPECIFYING VSAM EXTENT INFORMATION: You may specify extent information 
when you use the access method services control statements DEFINE SPACE, 
DEFINE MASTERCATALOG, DEFINE USERCATALOG, DEFINE CLUSTER (UNIQUE); or 


when you use the IMPORT or IMPORTRA functions for a unigue file. 

In many situations, VSE/VSAM does not require EXTENT information. 
See VSE/VSAM Programmer's Reference for information on when EXTENT 
information is required. 

When you enter the EXTENT option of the DLBL command, you are 
prompted to enter the disk extents for the specified file. You must 
enter extent information in accordance with the following rules: 


e For count-key-data devices, you must specify the starting track 
number and number of tracks for each extent, as follows: 


19 38 


This extent allocates 38 tracks, beginning with the 19th track, ona 
3330 device. 


e For fixed-block devices, you must specify the starting block number 


and the number of blocks for each extent. The following example 
allocates 200 blocks, starting at block number 352, on a fixed-block 
device. 

352 200 


Because VSAM rounds the starting block to the next highest cylinder 
boundary, it is advisable to specify the starting block on a cylinder 
boundary. 


e All count-key-data extents must begin and end on cylinder boundaries, 
regardless of whether the AMSERV file contains extent information in 
terms of cylinders, tracks, or records. 


e Multiple extent entries may te entered on a single line separated by 
commas or on different lines. Commas at the end of a line are 
ignored. 

e Multiple extents for the same volume must be entered in numerically 
ascending order; for example: 
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20 400, 600 80 
These extents are valid for a 2314 device. 


e When you enter nultivolume extents, you must specify the mode letter 
and logical unit associated with each disk that contains extents; 
extents for each disk must be entered consecutively. For example: 


assgn sys001 b 
assgn sys002 c 
assgn sys003 d 
dlbl filei b (extent sys001 
DMSDLB331R ENTER EXTENT SPECIFICATIONS: 
100 60, 400 80, 60 40 da sys003 
200 100 c sys002 
400 100 c sys002 
(null line) 


specifies extents on disks accessed at modes B, C, and D. These 
disks are assigned to the logical units SYS001, SYS002, and SYS003. 
Since B is the mode specified on the DLBL command line, it does not 
need to be respecified along with the extent information. 


e A DASD volume must be mounted, accessed, and assigned for each disk 
mode referenced in an extent. 


When you are finished entering extent information, you must enter a 
null line to terminate the DLBL command sequence. If you do not, an 
error may result and you will have to reenter the DLBL command. If you 
make any error entering the extents, you must reenter all the extent 
information. 


The DLBL command does not check the extents to see whether they are 
on cylinder boundaries or whether they are entered in the proper 
sequence. If you do not enter them correctly, the access method services 
DEFINE function will terminate with an error. 


CMS assigns sequence numbers to the extents according to the order in 
which they were entered. These sequence numbers are listed when you use 
the LISTDS command with the EXTENT option. 


In order to display the actual extents that were entered for a VSAM 
data set at DLBL definition time, the following commands may be entered: 


DLBL (EXTENT) or QUERY DLBL EXTENT 


Either of these commands will provide the following information to 
the user: 


DDNAME The VSE filename or OS ddname. 
MODE The CMS disk mode identifying the disk on which the extent 
resides. 


LOGUNIT The VSE logical unit specification (SYSxxx). This operand 
will be blank for a data set defined while in CMS/OS 
environment; that is, the SET DCS ON command had not been 
issued at DLBEL definition time. 


EXTENT Specifies the relative starting track number and pumber of 
tracks for each extent entered for the given dataset ddnane. 


If no DLBL definitions with extent information are active, the 
following message is issued: 
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DMSDLB324I NO USER DEFINED EXTENTS IN EFFECT 


IDENTIFYING MULTIVOLUME VSAM EXTENTS: When you want to execute a progran 
or use access method services to reference an existing multivolume VSAM 
data set, you may use the MULT option on the DLBL command that 
identifies the file. 


In many situations, VSE/VSAM does not require this information. See 
VSE/VSAM Programmer's Reference for information on when this’ type of 
EXTENT information is required. 


When you use the AULT option, you are prompted to enter additional 
disk mode letters, as follows: 


assgn sys001 
assgn sys002 
assgn sys003 
assgn sys004 
assgn sys005 
dlbl infile c (mult sys001 
DMSDLB330R ENTER VOLUME SPECIFICATIONS: 
d sys002, e sys003 , f sys004 
g sys005 

(null line) 


or oan 


The above identifies a file that has extents on disks accessed at modes 
C, D, E, F, and G. These disks have been assigned to the logical units 
SY¥SO01, SYS002, SYS003, SYS004, and SyYS0O05. The rules for entering 
multiple extents are: 


e All disks must be mounted, accessed, and assigned when you issue the 
DLBL command. 


e You must not repeat the mode letter and logical unit of the disk that 
is entered on the DLBL command line (C in the above example). 


e If you enter more than one mode letter and logical unit ona line, 
they must be separated by commas; trailing commas on a line are 
ignored. 


e A maximum of nine disks may be specified you do not need to specify 
them in alphabetical order. 


You must enter a null line to terminate the command when you are 


finished entering extents; if not, an error may result and you must 
reenter the entire command sequence. 


In order to display the volumes on which all multivolume data sets 
reside, the following commands are issued: 


DLBL (MULT) or QUERY LCLBL MULT 


The following information concerning multiple volume datasets is 
provided: 


DDNAME The VSE filename or OS ddname. 


MODE The CMS disk mode identifying one of the disks on which the 
dataset resides. 


LOGUNIT The VSE logical unit specification (SY¥Sxxx). This operand 
will be blank for a data set defined while in CMS/0OS 
environment; that is, the SET DOS ON command had not been 
issued at DLBL definition time. 
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If no DLBL definitions with multiple volume specifications are 
active, the following message 1S issued: 


DMSDLB324I NO USER DEFINED MULTS IN EFFECT 


USING VSAM CATALOGS: There are two special ddnames you must use_ to 
identify a VSAM master catalog and jok catalog: 


IJSYSCT identifies the master catalog when you initially define it 
(using AMSERV), and when you begin a terminal session. You 
should use the PERM oftion when you define it. 


You must assign the logical unit SYSCAT to the disk on which 
the master catalog resides. If you are redefining a master 
catalog that has already been identified, you may omit the 
SYSCAT option on the DLBL command line. 


IJSYSUC identifies a job catalog to be used for subsequent AMSERV jobs 
or VSAM programs. 


Any programmer logical unit may be used to assign a job 
catalog. 


Only one VSAM catalog is ever searched when a VSAM function is 
performed. If a ‘job catalog is defined, you may override it by using 
the CAT option on the DLBL command for a data set. The following DLBL 
command sequence illustrates the use of catalogs: 


assgn syscat c 
dlbl ijsysct c dsn mastcat (perm syscat 


identifies the master catalog, MASTCAT, for the terminal session. 


assgn sys010 d 
dlbl ijsysuc d dsn mycat (perm sys010 


identifies the job (user) catalog, MYCAT, for the terminal session. 


assgn sys100 e 
dlbl intest1 e dsn test.case (vsam sys100 


identifies a VSAM file to be used in a program. It is cataloged in the 
job catalog, MYCAT. 


assgn sys101 f 
dibl cat3 f dsn testcat (cat ijsysct sys101 


identifies an additional user catalog, which has an entry in the master 
catalog. Since a job catalcg is in use, you must use the CAT option to 
indicate that another catalog, in this case the master catalog, should 
be used. 

dlbl infile f dsn test.input (cat cat3 sys101 


identifies an input file cataloged in the user catalog TESTCAT, which 
was identified with a ddname of CAT3 on the DLBL command. 


The selection of a VSAM catalog for AMSERV jobs and VSAM programs 
running in CMS is Summarized in Figure 8. 
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Figure 8. Determining Which VSAM Catalog to Use 


Usage Notes for OS VSAM Users 


1. 


You may use the DLBL command to identify all access method services 
input and output files, and to identify all VSAM input and output 
files referenced in frograms. 


For all other file definitions, including OS or CMS disk files 
referenced in programs that use VSAM data management, you must use 
the FILEDEF command. 


File definition statements, either DLBL or FILEDEF, are not always 
required by VSAM. For more information on file definition 
requirements, see VSE/VSAM Programmer's Reference. 


A DLBL ddname may have a maximum of seven characters. If you have 
ddnames in your programs that are eight characters long, only the 
first seven characters are processed when the programs are executed 
in CMS. If you have two ddnames with the same first seven 
characters and you attempt to execute this program in CMS, you will 
receive an open error when the second file is opened. You should 
recompile these programs providing unique seven-character ddnames. 


If you release a disk for which you have a DLBL definition in 
effect, you should clear the DLBL definition before you execute a 
VSAM program or an AMSERV command. CMS checks that all disks for 
which there are DLBL definitions are accessed, and issues error 
message DMSSTTO69E if any are not. 
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4, The DLBL command does not support the DISP option. DISP is used in 
VSE/VSAM to specify the disposition of a reusable file. Therefore, 


in CMS, only the default values are available. For more 
information on the DISP option, refer to the VSE/VSAM Programmer's 
Reference. 


SPECIFYING VSAM EXTENT INFORMATION: You may specify extent information 


when you use the access method services control statements DEFINE SPACE, 
DEFINE MASTERCATALOG, DEFINE USERCATALOG, DEFINE CLUSTER (UNIQUE); or 
when you use the IMPORT or IMPORTRA functions for a unigue file. Space 
allocation is made only fcr primary allocation amounts. 


In many situations, VSE/VSAM does not require EXTENT information. 
See VSE/VSAM Programmer's Reference for information on when EXTENT 
information is required. 


When you enter the EXTENT option of the DLBL command, you are 
prompted to enter the disk extents for the specified file. You must 
enter extent information in accordance with the following rules: 


e For count-key-data devices, you must specify the starting track 
number and number of tracks for each extent, as follows: 


19 38 


This extent allocates 38 tracks, beginning with the 19th track, ona 
3330 device. 


e For fixed-block devices, you must specify the starting block number 
and the number of blocks for each extent. The following example 
allocates 200 blocks, starting at block number 352, on a fixed-block 
device. 


352 200 


Because VSAM rounds the starting block to the next highest cylinder 
boundary, it is advisable to specify the starting block on a cylinder 
boundary. 


e All count-key-data extents must begin and end on cylinder boundaries, 
regardless of whether the AMSERV file contains extent information in 
terms of cylinders, tracks, or records. 


e Multiple extent entries may be entered on a single line separated by 
commas or on different lines. Commas at the end of a line are 
ignored. 


e Multiple extents for the same volume must be entered in numerically 
ascending order; for exanrple: 


20 400, 600 80 
These extents are valid for a 2314 device. 


e When you enter nultivolume extents, you must specify the mode letter 
for extents on additional disks; extents for each disk must be 
entered consecutively. For example: 


dlibl filel b (extent 
DMSDLB331R ENTER EXTENT SPECIFICATIONS: 
100 60, 400 80, 60 40d : 
200 100 c 
400 100 c 
(null line) 
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specifies extents on disks accessed at modes B, C, and D. Since B is 
the mode specified cn the DLBL command line, it does not need to be 
respecified along with the extent information. 


e A DASD volume must be mounted and accessed for each mode referenced 
in an extent. 


When you are finished entering extent information, you must enter a 
null line to terminate the DLBL command sequence. If you do not, an 
error may result and you will have to reenter the entire DLBL command. 
If you make any error entering the extents, you must reenter all the 
extent information. 


The DLBL command does not’ check the extents to see if they are on 
cylinder boundaries or that they are entered in the proper sequence. If 
you do not enter them correctly, the access method services DEFINE 
function terminates with an error. 


CMS assigns sequence numbers to the extents according to the order in 
which they were entered. These sequence numbers are listed when you use 
the LISTDS command with the EXTENT option. 


IDENTIFYING MULTIVOLUME VSAM EXTENTS: When you want to execute a program 
or use access method services to reference an existing nultivolume VSAM 
data set, you may use the MULT option on the DLBL command that 
identifies the file. 


In many situations, VSE/VSAM does not reguire this information. See 
VSE/VSAM Programmer's Reference for information on when this’ type of 
EXTENT information is required. 


When you use the MULT option, you are frompted to enter additional 
disk mode letters, as follows: 


dibl infile c (sult 
DMSDLB330R ENTER VOLUME SPECIFICATIONS: 
d, e, £ 


(null line) 


The above example identifies a file that has extents on disks accessed 
at modes C, D, E, F, and G. The rules for entering nultiple extents are: 


e All disks must be mcunted and accessed when you issue the DLBL 
command. 


e You must not repeat the mode letter of the disk that is entered on 
the DLBL command line (C in the akove example). 


e If you enter more than one mode letter on a line, they must be 
separated by commas; trailing commas on a line are ignored. 


e A maximum of nine disks may be specified; you do not need to specify 
them in alphabetical order. 


You must enter a null line to terminate the command when you are 
finished entering extents; if not, an error may result and you nust 
re-enter the entire command sequence. 


GS: There are two special ddnames you must use to 
M master catalog and jok catalog: 


IJSYSCT identifies the master catalog, both when you initially define 
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it (using AMSERV) and when you begin a terminal session. You 
should use the PERM option when you define it. 


IJSYSUC identifies a job catalog to be used for subsequent AMSERV jobs 
or VSAM programs. 


Only one VSAM catalog is ever searched when a VSAM function is 
performed. If a job catalcg is defined, you may override it by using 
the CAT option on the DLBL command for a data set. The following DLBL 
command sequence illustrates the use cf catalogs: 
dlbl ijsysct c dsn mastcat (pern 

identifies the master catalog, MASTCAT, for the terminal session. 
dlbl ijsysuc d dsn mycat (pern 

identifies the job (user) catalog, MYCAT, for the terminal session. 


dlbl intest1 e dsn test.case (vsam 


identifies a VSAM file to be used in a program. It is cataloged in the 
job catalog, MYCAT. 


dlibl cat3 dsn testcat (cat ijsysct 
identifies an additional user catalog, which has an entry in the naster 
catalog. Since a job catalcg is in use, you must use the CAT option to 
indicate that another catalog, in this case the master catalog, should 
be used. 


dlbl infile e dsn test.input (cat cat3 


identifies an input file cataloged in the user catalog TESTCAT, which 
was identified with a ddname of CAT3 on the DLBL command. 


The selection of a VSAM catalog for AMSERV jobs and VSAM programs 
running in CMS is summarized in Figure 8. 


Responses 


If the DLBL command is issued with no operands, the current DLBL 
definitions are displayed at your terminal: 


ddnamel devicel [fn1l f£t1 fm1 [datasetnamel ]] 


ddnamen devicen [fnn ftn fmn [datasetnamen ]}] 
DMSDLB220R ENTER DATA SET NAME: 


This message is displayed when you use the DSN ? form of the DLBL 
command. Enter the exact DOS or OS data set name. 


DMSDLB320I MAXIMUM NUMBER CF DISK ENTRIES RECORDED 


This message indicates that nine volumes have been specified for a 
VSAM data set, which is the paximum allowed under CMS. 


DMSDLB321I MAXIMUM NUMBER OF EXTENTS RECORDED 


This message indicates that 16 extents on a Single disk or minidisk 
have been specified for a VSAM data space, catalog, or unique data 
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set. This is the maximum number of extents allowed ona minidisk 
or disk. 


DMSDLB322I DDNAME 'ddname' NOT FOUND; NO CLEAR EXECUTED 


This message indicates that the clear function was not performed 
because no DLBL definition is in effect for the ddname. 


DMSDLB323I {MASTER{ JOB} CATALOG DLBL CLEARED 


This message indicates that either the master catalog or job 
catalog has been cleared as a result of a clear request. 


You also receive this message if you issue a DLBL * CLEAR connand, 
and any DLBL definition is in effect for IJSYSCT or IJSYSUC that 
was not entered with the PERM cption. 


DMSDLB330R ENTER VOLUME SPECIFICATIONS: 
This message prompts you to enter volume specifications for 
existing multivolume VSAM files. (See "Identifying Multivolume VSAM 
Extents" in the appropriate usage section.) 

DMSDLB331R ENTER EXTENT SPECIFICATIONS: 
This message prompts you to enter the data set extent or extents of 
a new VSAM data space, catalog or unigue data _ set. (See 


"Specifying VSAM Extent Information" in the appropriate usage 
section.) 


Other Messages and Return Codes 


DMSDLBOO1TE NO FILENAME SPECIFIED RC=24 

DMSDLBOO3E INVALID OPTION ‘opticn'® RC=24 

DMSDLBOOSE NO "{CAT{BUFSP}' SPECIFIED RC=24 

DMSDLBO23E NO FILETYPE SPECIFIED RC=24 

DMSDLBOY8E INVALID MODE ‘mode! RC=24 

DMSDLBOSOE PARAMETER MISSING AFTER DDNAME RC=24 

DMSDLBO65E option! OPTION SPECIFIED TWICE RC=24 

DMSDLBO66E toption® AND "‘option* ARE CONFLICTING OPTIONS RC=24 

DMSDLBO69E DISK ‘mode NOT ACCESSED RC=36 

DMSDLBO7OE INVALID PARAMETER ‘parameter’ RC=24 

DMSDLBO86E INVALID DDNAME ‘ddname' RC=24 

DMSDLB109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 

DMSDLB221E INVALID DATA SET NAME RC=24 

DMSDLB301E "SYSxxx' NOT ASSIGNED FOR DISK 'fm' RC=36 

DMSDLB302E NO SYSXXX OPERAND ENTERED RC=24 

DMSDLB304E INVALID OPERANT VALUE ‘value RC=24 

DMSDLB305E INCOMPLETE EXTENT RANGE RC=24 

DMSDLB306E SYSXXX NOT ASSIGNED FOR "IGNORE RC=36 

DMSDLB307E CATALOG DDNAME 'ddname'* NOT FOUND RC=24 

DMSDLB308E 'mode't DISK IN {CMS| NON-CMS} FORMAT; INVALID FOR 
{NON-CMS|CMS} DATASET RC=24 
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Use the DOSLIB command to delete, compact, or list information about the 
executable phases ina CMS/DOS phase library. The format of the DOSLIB 
command is: 


DOSLIB 


| 


DEL likname phasenanel [...phasenamen ] 
COMP liktname 


MAP libname [ (opticns...[) ]] 


1ibname 


deletes phases from a CMS/LIOS phase library. The likrary is 
not erased when the last phase is deleted from the library. 


compacts a CMS/DOS phase likrary. 
lists certain information about the phases of a DOSLIB. 
Available information provided is phase name, size, and 


relative location in the likrary. 


is the filename of a CMS/DOS phase library. The filetype must 
be DOSLIB. 


phasenanel...phasenamen 


is the name of one or more phases that exist in the CMS/DOS 
phase library. 


MAP Options: The following oftions specify the output device for the 
MAP function. If more than one option is specified, only the first 
option is used. 


TERM 


PRINT 


displays the MAP output at the terminal. 
writes the MAP output to acCMS disk file with the file 
identifier of ‘likname MAP A5'*. If a file with that name 
already exists, the old file is erased. 


spools the MAP cutput to the virtual printer. 


Usage Notes 


1. 


2% 


The CMS/DOS environment does not have to be active when you issue 
the DOSLIB command. 


Phases may only be added to a DOSLIB by the CMS/DOS linkage editor 
as a result of the DOSLKED command. 
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3. In order to fetch a program phase from a DOSLIB for execution, you 
must issue the GLOBAL command to identify the DOSLIB. When a FETCH 
command or dynamic fetch from a program is issued, all current 
DOSLIBs are searched for the specified phases. 


4. If DOSLIBS are very large, or there are many of them to search, 
program execution is slowed down accordingly. To avoid excessive 
execution time, you shculd keep your DOSLIBsS small and issue a 
GLOBAL command specifying only those libraries that you need. 


Responses 


When you use the TERM cption on the DOSLIB MAP command line, the 
following is displayed: 


PHASE INDEX BLOCKS 
nanetl loc size 


DMSDSLOO2E FILE 'fn DOSLIB* NOT FOUND RC=28 

DMSDSLOO3E INVALID OPTION topticn® RC=24 

DMSDSLO13W PHASE "phase NCT FOUND IN LIBRARY 'fn DOSLIB fm' RC=4 
DMSDSLO14E INVALID FUNCTION ‘function' RC=24 

DMSDSLO37E DISK 'mode' IS READ/ONLY RC=36 

DMSDSLO4Y6E NO LIBRARY NAME SFECIFIED RC=24 

DMSDSLOY7E NO FUNCTION SPECIFIED RC=24 

DMSDSLO69E DISK ‘mode NOT ACCESSED RC=36 

DMSDSLO7VOE INVALID PARAMETER ‘parameter' RC=24 

DMSDSLOJ8E NO PHASE NAME SFECIFIED RC=24 

DMSDSL104S ERROR 'nn* READING FILE 'fn DOSLIB fm' FROM DISK RC=100 
DMSDSL105S ERROR 'nn* WRITING FILE 'fn DOSLIB fm' ON DISK RC=100 
DMSDSL213W LIBRARY ‘fn DOSIIE £m" NCT CREATED RC=4 
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Use the DOSLKED command in CMSyDOS to link-edit TEXT files from CMS 
disks or object modules from VSE private or system relocatable libraries 
and place them in executakle form in a CMS phase library (DOSLIB). The 
format of the DOSLKED command is: 


ee ee | 


r 1 
fn | libname| [ (options...[) ]] 
[in | 


L J 


DOSLKED 


options: 


— 


<= 
D> 
@ 
La 
@ 


Fh 
iB 


Specifies the name of the source file or module to be 
link-edited. CMS searches for: 


1. A CMS file with a filetype of DOSLNK 


2. A module in a private relocatable library (if IJSYSRL has 
been defined) 


3. A CMS file with a filetype of TEXT 


4. A module in the system relocatable library (if a mode was 
specified on the SET DOS ON command line) 


libname designates the name of the DOSLIB where the link-edited phase 
is to be written. The filetype is DOSLIB. If 1libname is not 
specified, the default is fn. The output filemode of the 
DOSLIB is determined as fcllows: 


e If libname DOSLIB exists on a read/write disk, that 
filemode is used and the output is appended to it. 


e If fn DOSLNK exists on a read/write disk, libname DOSLIB is 
written to that disk. 


e If fn DOSLNK exists on a read-only extension of a 
read/write disk, libname DOSLIB is written to the parent 
disk. 


e If none of the above apply, liktname DOSLIB is written to 
your A-disk. 
Options: Only one of the following options should be specified. If 
more than one is specified, only the first entry is used. 
DISK writes the linkage editor map produced by the DOSLKED command 


On your A-disk into a file with the filename of fn and a 
filetype of MAP. This is the default opticn. 
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PRINT spools the linkage editor map to the virtual printer. 


TERM displays the linkage editor map at your terminal. 


Note: All error messages are sent to the terminal as well as to the 


specified device. 


sage Notes 


You can create a CMS file with a filetype of DOSLNK to contain 


linkage editor control statements and, optionally, CMS text files. 


If you want to Jlink-edit a mcdule from a private relocatable 
library, you must issue an ASSGN command for the logical unit 
SYSRLB andenter a DLBL command using a ddname of IJSYSRL to 


identify the library: 


assgn sysrlb c 
dlbl ijsysrl c dsn reloc lik (sysrlb 


If you have defined a frivate relocatable library but do not want 


it to be searched, enter: 
assgn sysrlb ign 


to temporarily bypass it. 


CMS TEXT files may also contain linkage editcr control statements 
INCLUDE, PHASE, and ENTRY. The ACTION statement is ignored when a 


TEXT file is link-edited. 


To access modules on a VSE system residence volume, you must have 
specified the mode letter of the system residence on the SET DOS ON 


command line: 


set dos on z 


The search order that CMS uses to locate object modules to be 


link-edited is: 


a. The specified object module on the VSE private relocatable 


library, if one is available 


b. CMS disks for a file with the specified filename and with a 


filetype of TEXT 


c. The specified object module on the VSE system relocatable 


library, if it is availakle 


When a phase is added to an existing DOSLIB, it is always written 
at the end of the library. If a phase that is being added has the 
Same name as an existing phase, the DOSLIB directory is updated to 
point to the new phase. The old phase is not deleted, however; you 
should issue the DOSLIB ccmmand with the COMP option to compress 


the space. 


If you run out of Space in a DOSLIB while you are executing the 
DOSLKED command, you should reissue the DOSLKED command specifying 
a different DOSLIB, cr compress the DOSLIB before attempting to 


reissue the DOSLKED command. 


Prior to performing a DCSLKED on a TEXT file having multiple phase 
cards following the TEXT END cards, rename the filetype of TEXT to 


a filetype DOSLNK. 
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LINKAGE EDITOR CONTROL STATEMENTS: The CMS/DOS linkage editor recognizes 
and supports the VSE linkage editcr control statements ACTION, PHASE, 
ENTRY, and INCLUDE. The CMS/DOS linkage editor ignores: 


e The SVA operand of the PHASE statement 
e The Ftaddress form for specifying origin on the PHASE statement 
e The BG, Fn, and SMAFP operands of the ACTION statement 


The S-form of specifying the origin on the PHASE statement corresponds 
to the CMS user area under CMSy/DOS. If a default PHASE statement is 
required, the origin is assumed to Fe S. The PBDY operand of the PHASE 
statement indicates that the phase is link-edited on a 4K page boundary 
under CMS/DOS as opposed to a 2K page boundary for VSE. 


In VSE, an ACTION CLEAR control statement clears the unused portion 
of the core image likrary to binary zeros. In VSE, the core image 
library has a defined size, while in CMS/DOS the CMS phase library 
varies in size, depending on the number of phases cataloged. Therefore, 
in CMS/DOS an ACTION CLEAR control statement clears the current buffers 
to binary zeros before loading them; CMSyDOS cannot clear’ the entire 
unused portion of the CMS phase likrary because that portion varies as 
phases are added to and deleted from the CMS phase library. In CMS/DOS 
if you want your phases cleared you must issue an ACTION CLEAR control 
Statement each time you add a phase to the CMS phase library. 


LINKAGE EDITOR CARD TYPES: The input to the linkage editor can consist 
of six card types, produced by a language translator or a programmer. 
These cards appear in the following order: 


Card Type Definition 
ESD External symbol dictionary 
SYM Ignored by linkage editor 
TXT Text 
RLD Relocation list dictionary 
REP Replacement of text made by the programmer 
END End of module 


CMS/DOS supports these six card types in the same manner’ that VSE 
does. 


Responses 


When you use the TERM option of the DOSLKED command, the linkage editor 
map is displayed at the terminal. 


21012 INVALID OPERATION IN CONTROL STATEMENT 


This message indicates that a ;Llank card was encountered in the 
process of link-editing a relocatable module. This’ message also 
appears in the MAP file. The invalid card is ignored and 
processing continues. 


Other Messages and Return Codes 
DMSDLKOO1E NO FILENAME SPECIFIED RC=24 

DMSDLKOO3E INVALID OPTION ‘option’ RC=24 

DMSDLKOO6E NO READ/WRITE CISK ACCESSED RC=36 

DMSDLKOO7VE FILE ‘fn ft f£m* IS NOT FIXED, 80-CHAR. RECORDS RC=32 
DMSDLKO7OE INVALID PARAMETER ‘parameter’ RC=24 

DMSDLKOS9E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 

DMSDLK104S ERROR 'nn* READING FILE ‘fn ft fm*' FROM DISK RC=100 
DMSDLK105S ERROR ‘nn! WRITING FILE ‘fn ft £m' ON DISK RC=100 
CMSDLK21t10E LIBRARY "likrary' IS ON READ-ONLY DISK RC=36 
DMSDLK245S ERROR '‘nnn'* CN PRINTER RC=100 
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Use the DROPBUF command to eliminate the most recently created progran 
stack buffer. The format of the DRCPEUF command is: 


ng ae ee ae en ga ON ee eG Sey hE ce ee a ee Se eS ee Se fe ee ee SS a ee eee 
| DROPBUF | n i 
ae a a a a a a RE AL PO nT ee ON Se eA ee ee ee ES 


where: 

n indicates the number of the first program stack buffer you 
want to drop. CMS drops the indicated buffer and all buffers 
created after it. If nis not specified, only the most 
recently created kLuffer is dropped. 

Usage Note 


Note that you can specify a number with DROPBUF. For example, if you 
issue: 

DROPBUF 4 
CMS eliminates program stack buffer 4 and all program stack buffers 
created after it. Thus, if there were presently Six program stack 
buffers, CMS would eliminate program stack buffers 6, 5, and 4 If you 


issued DROPBUF without specifying n, only program stack buffer 6 would 
be eliminated. 


Responses 


None. 


Return Codes 


If an error occurs in DROPBUF processing, Register 15 contains one of 
the following nonzero return codes: 


Return 

Code Meaning 
1 Invalid buffer number specified 
Z Specified buffer does not exist 
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Use the DSERV command in CMS/DOS to obtain information that is contained 
in VSE private or system libraries. The format of the DSERV command is: 


| | r r+ | 
| | l [uni | l 
| DSERV | CD | PHASE {name [1213 | {d2 ...dn] [ (options...j) ]] | 
| | L L J J | 
| RD options: | 
l | SD c 1 \ 
I ( PD [DISK | | 
| | TD | TERM | i 
| | ALL | PRINT] | 
| - + l 
| { SORT ] | 
[a Jj 
where: 
CD specifies that informaticn concerning one or more types of 
RD directories is to be displayed or printed. The directory 
SD types that can be specified are: CD (core image library), 
PD RD (relocatarle library), SD (source statement library), 
TD PD (procedure library), TD (transient directory), and 
ALL ALL (all directories). 
There is no default value. The private libraries’ take 
precedence over system likraries. 
PHASE name 
specifies the name of the phase to ke listed. If the 
phasename ends with an asterisk, all phases that start with 
the letters preceding the asterisk are listed. This operand 
is valid only for CD. 
nn is the displacement within the phase where the version and 
level are to be found (the default is 12). 
[d2...dn] 
indicates additicnal libraries whose directories are to be 
listed. (See Usage Note 1.) 
Options: 


DISK writes the output on your CMS A—disk to a file named DSERV MAP 
A5. This is the default value if TERM or PRINT is not 
specified. 

TERM displays the output at your terminal. 

PRINT spools the output to the system printer. 


SORT sorts the entries for each library alphamerically; otherwise, 
the order is the order in which the entries were cataloged. 
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Usage Notes 


1. 


You may specify more than 
example: 


cne directcry on DSERV command line; for 


dserv rd sd cd phase $$borpen (tern 


of the relocatable and source statenent 
entry for the phase $$BOPEN from the core 


displays the directories 
libraries, as well as the 
lmage directory. 


You can 
however. 
one entered is listed. 


specify only one fhasename or phasename* at a tine, 
If you specify more than one PHASE operand, only the last 
For example, if you enter: 


dserv cd phase cor* phase idc* 


the file DSERV MAP contains a list of all phases that begin with 
the characters IDC. The first phasename specification is ignored. 


If you want to obtain informaticn from the directories of private 
source statement likrary directories, relocatable library 
directories, or core image library directories, the libraries nust 
be assigned and identified (via ASSGN and DLBL commands) when the 
DSERV command is issued. Otherwise, the system library directories 
are used. System directories are made available when you specify a 
mode letter on the SET DOS ON command line. 


The current assignments for logical units are ignored by the DSERV 
command; output is directed only to the output device indicated by 
the option list. 


Responses 


When you use the 


TERM option of the DSERV command, 


specified directory are displayed at your terminal. 


Other Messages and Return Codes 


DMSDSVOO3E 
DMSDSVO21W 
DMSDSVO22W 
DMSDSVO23W 
DMSDSVO24W 
DMSDSVO25W 
DMSDSVO26W 
DMSDSVO27E 
DMSDSVO27W 
DMSDSVO28W 
DMSDSVO4TE 
DMSDSVO65E 
DMSDSVO66E 
DMSDSVO7OE 
DMSDSVO95E 
DMSDSVO99IE 
DMSDSV105S 
DMSDSV245S 
DMSDSV4115 


RC=24 
RC=4 
RC=4 


INVALID GPTICN ‘option’ 
NO TRANSIENT DIRECTORY 
NO CORE IMAGE LIRECTORY 
NO RELOCATABLE DIRECTORY RC=4 

NO PROCEDURE DIRECTOFY RC=4 

NO SOURCE STATEMENT DIRECTORY RC=4 

‘phase NCT IN LIERARY RC=4 

INVALID DEVICE 'nn* RC=24 

NO PRIVATE CORE IMAGE LIERARY RC=4 

NO {PRIVATE|SYSTEM} TRANSIENT DIRECTORY ENTRIES 
NO FUNCTICN SPECIFIED RC=24 

‘option* OPTION SPECIFIED TWICE RC=24 

‘option’ AND ‘option! ARE CONFLICTING OPTIONS 
INVALID PARAMETER ‘parameter’ RC=24 
INVALID ADDRESS ‘address! RC=24 
CMS/DOS ENVIRCNMENT NOT ACTIVE RC=40 
ERROR 'nn* WRITING FILE "DSERV MAP A5* 
ERROR ‘nnn CN PRINTER RC=100 

INPUT ERROR CODE ‘'nn* ON {SYRES{SYSRLB} 


RC=4 


RC=24 


ON DISK RC=24 


RC=24 
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EDIT 


EDIT 


Use the EDIT command to invoke the VWM/SP System Product editor in CMS 
editor (EDIT) compatibility mode. Use the editor to create, modify, and 
Manipulate CMS disk files. In EDIT compatibility mode, you may execute 
both EDIT and XEDIT subcommands. For complete details on EDIT 
compatibility mode, refer to the publication VM/SP: System Product 
Editor Command and Macro Reference, “Appendix B". 


To invoke only the CMS editor, refer to the “Usage Note" below. 


Once the CMS editor has been invoked, you may only execute EDIT 
subcommands and EDIT macro requests, and enter data lines into the disk 
file. A limited number of CMS ccmmands may be executed in the CMS 
subset mode. Enter CMS sukset mode from the edit environment by issuing 
the EDIT subcommand, CMS. 


You can return control to the CMS environment by issuing the EDIT 
subcommands FILE or QUIT. 


For complete details on the EDII subcommand formats and usage, see 
"Section 3. EDIT Subcommands and Macros." For tutorial information on 
using the CMS editor, including examples, see the VM/SP CMS User's 
Guide. The format of the EDIT command is: 


OO Cs OO 


‘a 
| Edit | fn ft [fm] [ (options...[) }] | 
! [ * l 
| | options: | 
i | [ LRECL nn] 
l l [NODISP ] | 
to: Fee ae ee 
where; 
fn ft is the filename and filetype of the file to be created or 
edited. If a file with the specified filename and filetype 
does not exist, the CMS editor assumes that you want to create 
a new file, and after you issue the INPUT subcommand, all data 
lines you enter become input to the file. If a file with the 
specified filename and filetype exists, you may issue EDIT 
subcommands to modify the specified file. 
fn is the filemode of the file to be edited, indicating the disk 


on which the file resides. The editor determines the filemode 
of the edited file as follows: 


Editing existing files: If the file does not reside on your 
A-disk or its extensions, you must specify fn. 


When you specify fm, the specified disk and its extensions are 
searched. If a file is found on a read-only extension, the 
filemode of the parent disk is saved; when you issue a FILE or 
SAVE subcommand, the modified file is written to the parent 
disk. 


If you specify £m as an asterisk (*) all accessed disks are 
searched for the specified file. 


Creating new files: If you do not specify fm, the new file is 


written on your A-disk when you issue the FILE or SAVE 
subcomamands. 
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Options: 


LRECL nn is the record length of the file to be created or edited. 
Use this option to override the default values supplied by 
the editor, which are determined as follows: 


Editing Existing Files: Existing record length is’ kept 
regardless of format. If the file has variable-length 
records and the existing record length is less’ than the 
default record length, the default record length is used. 


Creating New Files: All new files have a_ record length of 
80, with the following exceptions: 


Filetype IRECL 
LISTING 121 
SCRIPT,VSELDATA 132 
FREEFORT 81 
The maximum record length supported by the editor is 160 
Characters. 
NODISP forces a 3270 display terminal into line (typewriter) node. 


When the NODISP option is in effect, all subcommands that 
control the display as a 3270 terminal such as_ SCROLL, 
SCROLLUP, and FORMAT (and CHANGE with no operands) are made 
invalid for the edit session. 


>: It is recommended that the NODISP option always be 
when editing on a 3066. 


Usage Note 


When you, issue the EDIT command, an EXEC named EDIT EXEC S2 is executed. 
This EXEC invokes the VM/SP System Product editor in EDIT compatibility 
node. 


If you want to invoke only the CMS editor on a permanent basis, your 
system programmer must rename this EXEC. Then, when you issue the EDIT 
command, the EXEC will not execute and the CMS editor will be invoked. 


If you want to invoke the CMS editor only for a particular edit 
session, specify OLD on the EDIT command line. CMS passes the OLD 
parameter to EDIT EXEC S2 and only the CMS editor is invoked. Note that 
the old editor has not been enhanced for VM/SP and will not be enhanced 
for future releases; specifically the old editor will not include any 
support for new display devices. 


Responses 
NEW FILE: 
The specified file dces not exist. 


EDIT: 


The edit environment is entered. You may issue any valid EDIT 
subcommand or macro reguest. 
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The input 
REPLACE or INPUT with no oferands. 


EDIT 


EDIT subcommands 
All subseguent input lines are 


environment is entered by issuing the 


accepted as input to the file. 


Other Messages and Return Codes 


DMSEDIOO3E 
DMSEDIO24E 
DMSEDI029E 
DMSEDIOMGE 
DMSEDIOSGE 
DMSEDIO69E 
DMSEDIO76E 
DMSEDI104S 
DMSEDI105S 
DMSEDI117S 
DMSEDI132S 
DMSEDI143S 
DMSEDI144S 
DMSEDX069E 


INVALID OPTION ‘option RC=24 


FILE "EDIT CMSUT1 fm' ALREADY EXISTS RC=28 

INVALID PARAMETER ‘parameter' IN THE OPTION 'LRECL' FIELD RC=24 
RECORD LENGTH EXCEEDS ALLOWABLE MAXIMUM RC=32 
INCOMPLETE FILEIC SPECIFIED RC=24 

DISK "modet NOT ACCESSED RC=36 

ACTUAL RECORD LENGTH EXCEEDS THAT SPECIFIED RC=40 
ERROR 'nn' REALTING FILE ‘fn ft fm" FROM DISK RC=100 
ERROR 'nn* WRITING FILE ‘fn ft fm" ON DISK RC=100 
ERROR WRITING TO DISPLAY TERMINAL RC=100 

FILE ‘fn ft fm" TOO LARGE RC=88 

UNABLE TO LOAD SAVED SYSTEM OR LOAD MODULE RC=40 


REQUESTED FILE IS IN ACTIVE STATUS 
DISK ‘mode' NOT ACCESSED kRC=36 
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ERASE 


Use the ERASE command to delete one cr more CMS files from a read/write 


disk. 


The format of the ERASE command is: 


fa ist [fm] [(options...[)]] options: 
c* ] 


where: 
fn is the filename of the file(s) to be erased. An asterisk 
coded in this position indicates that all filenames are to be 
used. fn must be specified, either with a name or an 
asterisk. 
ft is the filetype of the file(s) to be erased. An asterisk 
coded in this position indicates that all filetypes are to be 
used. This field must be specified, either with a name or an 
asterisk. 
fn is the filemode of the files to be erased. If this field is 
omitted, only the A-disk is searched. An asterisk coded in 
this position indicates that files with the specified filename 
and/or filetype are to be erased from all read/write disks. 
Options: 
TYPE displays at the terminal the file identifier of each file 
erased 
NOTYPE 


file identifiers are not displayed at the terminal. 


Usage Notes 


Abs 
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If you specify an asterisk for ftoth filename and filetype you must 
specify both a filemode letter and number; for example: 


erase * * a5 


To erase all files on a particular disk, you can use the FORMAT 
command to reformat it, or you can access the disk using the ACCESS 
command with the ERASE option. 


If an asterisk is entered as the filenode, then either the filename 
or the filetype or both must be specified by name. 
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Responses 


If you specify the TYPE option, the file identification of each file 
erased is displayed. For example: 


erase oldfile temp (tyre 
results in the display: 


OLDFILE TEMP Al 
RG 


DMSERSOO2E FILE ['fn [ft [fm]]*] NOT FOUND RC=28 
DMSERSOO3E INVALID OPTION ‘option RC=24 
DMSERSO37E DISK ‘mode! IS READ/ONLY RC=36 
DMSERSOUBE INVALID MODE ‘mode RC=24 

DMSERSOSHE INCOMPLETE FILEID SPECIFIED RC=24 
DMSERSO69E DISK ‘mode* NOT ACCESSED kRC=36 
DMSERSO7VOE INVALID PARAMETER ‘parameter' RC=24 
DMSERSO71E ERASE * * [*|{mode] NOT ALLOWED RC=24 
DMSERS109T VIRTUAL STORAGE CAPACITY EXCEEDED 


Note: You can invoke the ERASE command from the terminal, from an EXEC 
file, or as a function from a program. If ERASE is invoked as a function 
or from an EXEC file that has the &CONTROL NOMSG option in effect, no 
e€rror message is issued. 
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ESERV 


Use the ESERV EXEC procedure in CMS/DOS to copy edited VSE macros fron 
system or private source statement E sublitfraries to CMS disk files, or 
to list de—edited macros. The format of the ESERV command is: 


fn specifies the filename of the CMS file that contains the ESERV 
control statements; it must have a filetype of ESERV. The 
logical unit SYSIPT must be assigned to the disk on which the 
ESERV file resides. fn is also the filename of the LISTING 
and MACRO files produced by the ESERV progran. 


Usage Notes 


1. The input file can contain any or all of the ESERV_ control 


2. You must have a read/write A-disk accessed when you use the ESERV 
command. 


3. To copy macros from the system source statement library, you must 
have entered the CMS/DOS environment specifying the mode letter of 
the VSE system residence. To copy from a private source statement 
library, you must assign the logical unit SYSSLB and issue a DLBL 
command for the ddname IJSYSSL. 


4. The output of the ESERV program is directed (as in VSE/AF) to 
devices assigned to the logical units SYSLST and/or SYSPCH. If 
either SYSLST or SYSPCH is not assigned, the following files are 
created: 


Unit Qutput File 


SYSLST fn LISTING mode 
SYSPCH fn MACRO node 


where mode is the mode letter of the disk on which the source file, 
fn ESERV resides. If fn ESERV is on a read-only disk, the files are 
written to your A-disk. 


You can override default assignments made by the ESERV EXEC as 
follows: 


e If you assign SYSIPI to TAPE or READER, the source statements 
are read from that device. 


e If you assign SYSLST or SYSPCH to another device, the SYSLST or 
SYSPCH files are written to that device. 


5. The ESERV EXEC procedure clears all DILBL definitions, except those 
entered with the PERM opticn. 


6. If you want to use the ESERV command in an EXEC procedure, you must 
use the EXEC command (because ESERV is also an EXEC). 
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7. When you use the ESERV control statements PUNCH or DSPCH, the ESERV 
program may generate CATAL.S, END, or /* records in the output 
file. When you adda MACRO file containing these statements to a 
CMS macro library using the MACLIB command, the statements are 
ignored and are not read into the MACLIB member. 


8. Any DISKS accessed with a mode letter of 'R' or 'T* should be in 
read/fonly mode when an ESERV is running on then, otherwise message 
DMSDLB301E may occur. 


Responses 


None. The CMS ready message indicates that the ESERV program completed 
execution successfully. You may examine the SYSLST output to verify the 
results of the ESERV program execution. 


Error Messages and Return Codes 
DMSERVOO1TE NO FILENAME SPECIFIED RC=24 

DMSERVOO2E FILE ‘fn ESERV!' NOT FOUND RC=28 

DMSERVOO6E NO READ / WRITE LISK ACCESSED RC=36 
DMSERVO27E INVALID DEVICE * device * FOR SY¥Sxxx RC=28 
DMSERVO37E DISK 'mode' IS READ ONLY RC=36 

DMSERVO7OE INVALID ARGUMENT * argument § RC=24 
DMSERVOSSE CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 


Note: The ESERV EXEC calls other CMS commands to perform certain 
functions, and so you May, on occasion, receive error messages’ that 
occur as a result of those commands. 


Non-CMS error messages produced by the VSE ESERV program are 
described in the Guide to the DOS/VSE Assembler. 
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Use the EXEC command to execute one or more CMS commands or EXEC control 
statements contained in a specified CMS EXEC or EXEC2 file. The format 
of the EXEC command is: 


| [EXec] | fn [args...] | 
i i a el 

where: 

[ EXec] indicates that the EXEC command may be omitted if you are 


executing the EXEC procedure from the CMS command environment 
and have not issued the command SET IMPEX OFF. 


fn is the filename of a file containing one or more CNS commands 
and/or EXEC control statements to be executed. The filetype 
of the file must ke EXEC. The file can have either fixed- or 
variable-length records with a logical record length not 
exceeding 130 characters. A text editor or a user program can 
create EXEC files. EXEC files a CMS editor creates have, by 
default, variable-length, 80-character records. 


args are any arguments you wish to pass to the EXEC. The CMS EXEC 
processor asSignS arguments to special variables 6&1 through 
630 in the order in which they appear in the argument list. 
The EXEC 2 processor assigns arguments to special variables 
Starting with special variable &1. With the EXEC 2 processor, 
the number of arguments is not linited. However, the number 
of bytes of data you can fass in the argument list is limited. 
The limit is the maximum number of bytes that can fit ina 
line: 130 bytes if the command is entered from a terminal, 
255 bytes if the command is issued from a frogran. 


"Section 5. EXEC Control Statements" contains complete descriptions 
of EXEC control statements, special variables, and built-in functions. 
For information on designing EXEC procedures and examples of control 
word usage, see the VH/SP CMS User's Guide. 


See VM/SP EXEC 2 Reference for information about EXEC 2. 


Responses 
The amount of information displayed during the execution of an EXEC 
depends on the setting of the &CONTROL control statement. By default, 
ECONTROL displays all CMS commands, responses, and error messages. In 
addition, it displays nonzero return codes from CMS in the format: 

+++ RK (nnnnn) +++ 
where nnonnn is the return code from the CMS command. 


For details, see the description of the &CONTROL control statement in 
"Section 5. EXEC Control Statements." 


The amount of information displayed during the execution of an EXEC 2 


file depends on the setting of the &TRACE control statement. See VM/SP 
EXEC 2 Reference for details. 


102 IBM VM/SP CMS Command and Macro Reference 


| If the EXEC 2 interpreter finds an error, 


Messages and Return Codes 


DMSEXCOO1E NO FILENAME SPECIFIED RC=24 


DMSEXTO72E ERROR IN EXEC FILE filename, LINE nnnn - description 


Description 

FILE NOT FOUND 

&SKIP OR &GOTO ERROR 

BAD FILE FORMAT 

TOO MANY ARGUMENTS 

MAX DEPTH OF LOOP NESTING EXCEEDED 
ERROR READING FILE 

INVALID SYNTAX 

INVALID FORM OF CONDITION 
INVALID ASSIGNMENT 

MISUSE OF SPECIAL VARIABLE 
ERROR IN &SERROR ACTION 
CONVERSION ERROR 

TOO MANY TOKENS IN STATEMENT 
MISUSE OF BUILT-IN FUNCTION 
EOF FOUND IN LOOP 

INVALID CONTROL WORD 

EXEC ARITHMETIC UNDERFLOW 
EXEC ARITHMETIC OVERFLOW 


SPECIAL CHARACTER IN VARIABLE SYMBOL 


DMSEXEO85E ERROR IN fn ft fm, LINE nnn - description 


Description 

FILE NOT FOUND 

WRONG FILE FORMAT 

WORD TOO LONG 

STATEMENT TOO LONG 

INVALID CONTROL WCRD 

LABEL NOT FOUND 

INVALID VARIABLE NAME 
INVALID FORM OF CONDITION 
INVALID ASSIGNMENT 

MISSING ARGUMENT 

INVALID ARGUMENT 

CONVERSION ERROR 

NUMERIC OVERFLOW 

INVALID FUNCTION NAME 

END OF FILE FOUND IN LOOP 
DIVISION BY ZERO 

INVALID LOOP CONDITION 

ERROR RETURN DURING &SERROR ACTION 
ASSIGNMENT TO UNSET ARGUMENT 
STATEMENT OUT OF CONTEXT 
INSUFFICIENT STORAGE AVAILABLE 
FILE READ ERROR non 

TRACE ERROR nnn 


If the EXEC interpreter finds an error, it displays the message: 


The possible errors, and the associated return codes, are: 


Return 
Code 


801 
802 
803 
804 
805 
806 
807 
808 
809 
810 
811 
812 
813 
814 
815 
816 
817 
818 
819 


it displays the message: 


The possible errors and the associated return codes are: 
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EXEC 


DMSEXE255T INSUFFICIENT STORAGE FOR EXEC INTERPRETER RC=10096 


DMSEXE175E INVALID EXEC COMMAND RC=10000 
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Use the EXECIO command to: 
e Read lines from disk or virtual reader to the program stack. 


e Write lines from the program stack to a CMS disk file or to a virtual 
spool device (punch or frinter). 


e Cause execution of CP commands and recover resulting output. 


In some cases output data to be written may be supplied directly on the 
EXECIO command line. 


The information immediately following is reference level information 
about EXECIO format and operands. Following this reference information 
you can find extended descriptive and use information. If you are not 
familiar with EXECIO, you should review the complete command description 
before attempting to use it. Also, to get full benefit from EXECIO you 
should be familiar with use of execs under EXEC 2.(Refer to the EXEC 2 
Reference, SC24-5219). 


In the following descriptions, ‘relative line number means the number 
of lines processed to satisfy an EXECIO operation; ‘absolute line 
humber' means the number of the line relative to the top of the file. 


The format of the EXECIO command is: 
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eg age a nS SG ee ee ee EL NT SS ee ee 
| | | 
| EXECIO oe DISKR fn ft [fm [linenun]] [ ([FINIsS] options [a] [b]] CW 
| | . CARD [ ( options ja] [b]] C) }}l 
| | CP C ( options [a] (/b] [d]][) ]jI 
| | DISKW fn ft fo [linenun { 
| [ {recfm [lrecl]]] [([FINIs] options [b] [c] [d]] [) ]/l 
| | PUNCH [ ( options [b] [c] [d]] Ll) ]]1 
| PRINT [ ({CC Rede options [b] [c][ 4d]] [) J] 
| Cf DATA § ] I 
| | EMSG [ ( options [b] [c] [d]] [) }J I 
| | | 
| I 
| Option formats: | 
| | 
! (a) (b) (Cc) (d) ; 
I 
| Find /chars/ Margins \n1 n2 CAse 4; JU STring xxx... | 
| LOcate /chars/ | +e M { 
| Avoid /chars/ STRIP | 
| I 
{ Zone jn n2 NOTYPE | 
| i ae I 
| | 
| LIFO | 
| FIFO | 
| | 
| SKip | 
| I 
{| Note: Parsing of the EXECIO command differs from that of other CMS | 
| commands in that it involves handling of strings that may | 
| contain embedded blanks, parenthesis, other special characters, | 
| and words of more than eight characters. Therefore, if a right | 
| parenthesis is used to mark the end of an EXECIO option, it must | 
| be preceded by at least one Elank character. A right parenthesis | 
| cannot be used to mark the end of the STRING option. | 
| | 
ee 4 
where: 
lines is the number of source lines processed. This can be any 
non-negative integer. An asterisk (*) indicates that’ the 
operation is to terminate when: 
a. a null (O-length) line is read during an output operation; 
b. an end-of-file condition is detected during an input 
operation. 
Specification of *, together with the STRING option, is valid 
only with the CP operand. Using the * and STRING combination 
with any other operand causeS an error message to be issued. 
If ‘'lines' is specified as zero (0), no I/0O operation is 
performed other than FINIS, if it is specified as an option. 
DISKR is used to read a specified number of lines from the CMS file 
"fn ft [fm]*' to the program stack FIFO (first-in first-out). 
CARD is used to read a specified number of lines from the virtual 
reader to the program stack (FIFO). 
cP causes output resulting from a CP command to be placed on the 
program stack (FIFO). You may specify which CP command is to 
be issued via: 
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DISKW 


recfm 
lrecl 


PUNCH 


PRINT 


CC 


code 


DATA 


EMSG 


fn 


ft 


fm 


EXECIO 


a. the STRING oftion on the EXECIO command line; 
b. the next line from the program stack. 


is used to write a specified number of lines from the progran 
stack to a new or existing CMS file 'fn ft fm'. 


Inserting a line into a variable length CMS file can cause 
truncation of the portion of the file following the inserted 
line. See the extended DISKW operand description. 


define the record format and record length for any new file 
created as a result of a DISKW operation. The default value 
for recfm is V (variable), in which case ‘'lrecl' has no 
meaning. If you specify F (fixed) for recfm, the default 
lrecl value is 80. The maximum Jlrecl value that may be 
Specified is 255. 


is used to transfer a specified number of lines from the 
program stack to the virtual punch. 


is used to transfer a specified number of lines from the 
program stack to the virtual printer. 


is used with the PRINT operand to specify carriage control for 
each line transferred to the virtual printer. Using the CC 
operand, you can supply carriage control code explicitly, or, 
by specifying DATA, indicate that the carriage control 
character is the first byte of each line. 


is the character (ASA or machine code) that defines carriage 
control. A klank code (the default value) cannot be specified 
on the command line. 


specifies that the first byte of each line sent to the virtual 
printer is a carriage control character. 


causes a message to be displayed. The text of the message may 
be: 


a. the character string specified on the STRING option; 
b. the next available line(s) from the program stack. 


Messages are edited according to the current CP SET EMSG 
settings. 
is the filename of the file. 


is the filetype of the file. 


is the filemode of the file. When filemode is specified, that 
disk and its extensions are searched. If filemode is not 
Specified, or is specified as an asterisk (*), all accessed 
disks are searched for the specified file. 
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linenun 


FINIS 


Options: 
(Option a) 


FIND 


LOCATE 


AVOID 


ZONE 


LIFO 
FIFO 


SKIP 


is the absolute line number within the specified file where a 
DISKR or DISKW operation is to begin. If a value is. not 
specified (default is 0) for newly opened files, reading 
begins at the first line and writing begins at the last line. 
For other files, reading or writing begins at the line 
following the one at which the previous operation ended. 


causes the specified file to be closed following completion of 
a DISKR or DISKW operation. 


is used to write to the progran Stack LIFO (last-in 
first-out) : 


1. the contents of that line; 

2. the line number of the first occurrence of a line (or zone 
portion of that line) that begins with the characters 
specified between delimiters. For DISKR operations both 
the relative and absolute line numbers are written. 
Otherwise, only the relative line number is written. 


If you wish to search only a portion of each line, use the 
ZONE option, explained below. If you wish to write only a 
portion of any line matching the search argument to the 
program stack, use the MARGINS option, also explained below. 


is like the FIND option explained above, except that the 
object characters may occur any place within a line (or zone 
portion of that line). 


is like the LCCATE option explained above, except that the 
search is for a line (or zone portion of that line) that does 
not contain the specified characters. 


is used to restrict the portion of the input lines searched as 
a result of the FIND, LOCATE, or AVOID options. The search is 
between columns n1 and n2 (inclusive), if specified. The 
default values are column 1 through the end of the line (*). 
The limits of values that may be specified for n1 or n2 are 1 
through 255. 


defines the order in which lines are written to the progran 
stack. Generally, the default order is FIFO (first-in 
first-out). The exceptions are operations that put line 
numbers on the program stack as a result of a search operation 
(FIND, LOCATE, or AVOID). These operations default to LIFO 
(last-in first-out). 


allows a read function (DISKR, CARD, CP) to occur without 
writing any information to the program stack. 
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(Option b) 


MARGINS Specifies that only a portion (columns 11 through n2 
inclusive) of affected lines is to be put on, or taken fron 
the program stack. The default values are column 1 through 
the end of each line (*). The limits of values that may be 
specified for nil or n2 are 1 through 255. 


STRIP specifies that trailing blank characters are to. be removed 
from any output lines or lines put on the program stack. 


NOTYPE Suppresses the display of message DMSEIC632E at the virtual 
console. 

(Option c) 

CASE causes data read from the program stack to be: 


a. translated to uppercase if U is specified; 
b. not translated (mixed) if M is specified. 


M (mixed) is the default value. 


(Option 4d) 


STRING is used to supply output data explicitly on the EXECIO command 
line. Any characters following the STRING keyword are treated 
as string data, not additional EXECIO operands. Therefore, 
STRING, if specified, must be the final option on the command 
line. 


EXECIO commands are normally issued as statements from execs running 


under EXEC 2. Because some EXECIO option values can exceed eight 
characters, an extended parameter list is reguired for EXECIO execution 
with options specified. Otherwise, an error message results. EXEC 2 


supplies an extended parameter list. 


You should keep in mind that when acCMS operation completes and the 
READY message (R;) displays, CMS closes all files. Any subsequent 
EXECIO read operation will begin at file line one unless a ‘'linenun' 
value is specified. Any subsequent EXECIO write operation will begin at 
the end of the file unless a ‘linenum' value is specified. Therefore, 
when possible, it is a good idea to specify a ‘linenum' value on the 
EXECIO command line. 


For write operations, data to be written is normally taken from the 
program stack. However, data to be written may be supplied via the 
STRING option if, as is the case when using EXEC 2, an extended 
(nontokenized) parameter list is provided. 

Program stack 


The program stack is a kuffer area, expanded as necessary from available 
free storage. Data flow into and out of the program stack is: 


a. normally FIFO (first-in first-out) for read or write operations; 
b. LIFO (last-in first-out) for read options, such as FIND or LOCATE, 
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that result in a line number being stacked. 


A successful search (LOCATE, FIND, etc.) operation results in two lines 
being written (LIFO) to the rrogram stack: 


1. the contents of the line that satisfied the search argument; 

2. the relative line number (number of lines read to obtain a match for 
the search argument), and for a DISKR operation only, the absolute 
line humber (positicn from the top of the file). 


Stacked line number values may be used on subsequent EXECIO operations 
for 'lines' or 'linenunm' operands. 


The CMS SENTRIES command results in a return code equal to the number of 
lines in the program stack. Thus, the difference between SENTRIES 
return codes, one before and one after an EXECIO operation, is the 
number of lines stacked as a result of that operation. 


Closing files and virtual devices 


EXECIO (DISKR or DISKW) operations do not close referenced files when 
the operation terminates unless the FINIS operand is specified on the 
command line. If you choose, you may close these files manually by 
invoking the CMS FINIS command. There is considerable system overhead 
associated with the execution of FINIS. Therefore, if multiple 
references are to be made to a given file, it should be closed only when 
necessary. 


If successive EXECIO commands reference a particular internal area of a 
CMS file, it is probably more efficient to let the file remain open 
until the last of these commands is issued. If so, each operation 
begins at the file line following the last line processed. This 
eliminates much of the need for calculating the ‘linenum' value. 


EXECIO does not close virtual spool devices. Therefore, to cause any 
spooled EXECIO output to be processed you must close the corresponding 
device. For example: 


CP CLOSE PRINTER 


‘lines' operand 


For a DISKW, PUNCH, PRINT, or EMSG operation, if the ‘lines' operand 
exceeds the number of lines on the program stack, reading continues 
through the terminal input buffer. If the ‘lines' operand is still not 
Satisfied, a VM READ is issued to the terminal. At that point, you must 
enter the balance of the lines (the number specified in the ‘lines' 
operand) from the terminal. Entering a blank character (null line) does 
not terminate the EXECIO operation; it writes a blank character to the 
output device. When the ‘lines' operand has been satisfied, the exec 
from which EXECIO was issued continues to execute. 


If * (to end of file) is specified for "lines* on an output operation, 
and you want the operation to terminate at any given line in the progran 
stack, you must make sure that line is null. Reading a null line 
terminates any of the four cutput operations if * is specified for the 
"lines operand. 


For input operations, the number of lines written to the program stack 
does not necessarily equal the number specified by ‘lines'. For 
example, an end-of-file or a satisfied search condition terminates a 
read operation, even if the specified number of lines has not been 
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written to the program stack. When a search argument (FIND, LOCATE, 
AVOID option) is satisfied, and no SKIP option is specified, and the 
default stacking order (LIFO) is used, the line at the top (first line 
out) of the stack contains the number of operations required to satisfy 
the search. The next line contains the line that satisfied the search. 


DISKR operation 
The first line read on a DISKR operation may be: 


a. the first line of the specified file; 
b. specified using the ‘linenum' operand; 
c. determined by the results of a previous operation. 


The DISKR operation may be used to simply read a specified number of 
lines from a specified file and write them to the program stack. For 
example, suppose file MYFILE DATA contains: 


The number one color is red 

The number two color is yellow 
The number three color is green 
The number four color is Llue 
The number five color is black 


The command: 
EXECIO 2 DISKR MYFILE DATA * 1 


writes to the program stack (FIFO) two lines beginning with line one, 
like this: 


2 
| The number one color is red j<-next line read 
| The number two color is yellow | 
| . | 
/ - / 


However, a little more ccmplex version of this command: 
EXECIO 2 DISKR MYFILE DATA * 3 (LIFO MARGINS 5 14 


would have resulted in this frogram stack: 


_ 
| number fou |<-next line read 
| number thr | 
| ° I 
/ ° / 


Note the use of * as a filemode operand on the command lines just above 
to serve as a place holder. 


When a line satisfies the LOCATE, FIND, or AVOID option for a DISKR 
operation, EXECIO writes that line to the program stack (LIFO), and in 
an additional stack line, writes the relative (number of lines read to 
Satisfy the search) and absolute (position from the top of the file) 
line numbers. 


CP operand 
When a search argument is required, the CP operand uses the FIND, 


LOCATE, and AVOID options to process output resulting from _ the 
associated CP command. The line that satisfies the search criteria is 
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written to the program stack. Any data in excess of 8192 characters is 
truncated and an error code is returned. The number of read operations 
required to match the search argument is written to the next stack line. 


If you do not supply the CP command to be issued via the STRING option, 
the next line in the program stack is treated as that command. If there 
are no lines in the program stack, the next line in the console input 
buffer is treated as the CP command. If there are no lines in the 
console input buffer, then a VM READ is issued to the terminal. A null 
line terminates the operation. 


Keep in mind that all characters of CP commands must be uppercase. 
ZONE and MARGINS options do not affect the reading of the CP command; 


however, they do affect the portions of the lines processed as a result 
of the command execution. 


ISKW operand 


The DISKW operand causes the next lines from the program stack to be 
written to a CMS file. The point at which writing begins in an existing 
file on a DISKW operation may: 


a. follow the last file line (default ‘linenum' when writing to a newly 
opened file, for example); 


b. be specified using the 'linenum' oferand; 


c. be determined by the results of a previous operation. 


For example, suppose you want to write 10 lines from the program stack 
to the end of an existing A-disk file, BUCKET STACK A. Your exec file 
statement to do this would be: 


EXECIO 10 DISKW BUCKET STACK A 


Now, take a slightly more complex requirement. Using stack lines down 
to the first null line, create a new A-disk file, EASKET STAX A, then 
close the file after it is written. Also, make the file fixed length 
format with a record length cf 60. The EXECIO command to do this is: 


EXECIO * DISKW BASKET STAX A 1 F 60 (FINIS 


A word of caution about using the linenum operand to insert lines in the 
middle of CMS variable length files. Because of the way CMS handles 
these files, any variable length line inserted must be equal in length 
to the line it displaces. Otherwise, for disks formatted in: 


a. 1K, 2K, or 4K blocks, all file lines following the one inserted are 
truncated; 

b. 800-byte blocks, the file remains unchanged and CMS issues message 
105S (nn=15). 


For example, assume a disk format in 2K blocks. The variable format 
file WORDS LEARNING A is: 


is for apple 
is for cake 
is for candy 
is for dog 


D000 > 


execution of: 
EXECIO 1 DISKW WORDS LEARNING A 2 (STRING B is for kLutterfly 


produces a file that contains only: 
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A is for apple 
B is for butterfly 


Because 'B is for butterfly' contains more characters than the line it 
writes over, ‘'C is for cake', all lines following it are truncated. 
However, Slightly modifying the command to: 


EXECIO 1 DISKW WORDS LEARNING A 2 (STRING B is for baby 
results in: 
is for apple 
is for baby 


is for candy 
is for dog 


oO Ww > 


To prevent truncation when inserting records in a variable-length file, 
you can use fixed-format files. 


recfn 
irecl operands 


The default value for recfm is V (variable), in which case 'lrecl' has 
no meaning. If you specify F (fixed) for recfm, the default lrecl value 
is 80. The maximum lrecl value that you may specify is 255. 


When lines are written to an existing file, the record format and record 
length of that file apply. Specifying recfm or Ilrecl values on the 
EXECIO command line that conflict with those of the existing file causes 
an error message to be issued. 


CC operand 


When you specify CC together with the DATA operand, be sure the first 
character of each line to be sent to the virtual printer may be removed 
and interpreted as carriage control for that line. 


You may use ASA or machine code characters with the CC operand to 
specify carriage control. For example, CC 0 causes space two lines 
before printing. You can find information about these codes under the 
PRINTL macro description in VM/SP CMS Command and Macro Reference. 


EMSG operand 
Lines to be displayed by EMSG should have the format: 
xxXxxDmMnnns 
where: 
XXxmmm is the issuing module nane 
nnn is the message number 
s indicates the message type (E - error, I - informational, W - 
warning etc.) 
The current settings of the CP SET EMSG command control the displayed 


lines. These settings, combined with message length, can cause nessages 
to be abbreviated or not displayed at all. 
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linenum operand 


When a linenum value (default 0) is not specified on the EXECIO command 
line, the number of the next file line available for reading or writing 
depends on results of previous operations that referenced that file. 
For example, consider the two EXECIO DISKR operations just below. By 
looking at the first of these commands you can see: 


a. Four lines are to be read from MYFILE DATA, starting at line 1; 
b. Because FINIS is not specified on the command line, MYFILE DATA 


remains open after the first read operation. Because the first 
command reads 4 lines, the subseguent read operation will begin at 
line 5. 


EXECIO 4 DISKR MYFILE DATA * 1 


EXECIO 3 DISKR MYFILE DATA (FINIS 
Because the second EXECIO command specifies no linenum operand, reading 
of the specified 3 lines begins at line 5. 


Two Situations that would cause the second EXECIO command to not begin 
execution at line 5 are: 


a. a program other than EXECIO accessing MYFILE DATA after the first and 
before the second EXECIO command ig executed; 

b. a CMS operation completing such that the CMS READY message (R;) is 
displayed. In that case CMS closes associated files. Therefore, 
subsequent operations using these files would begin at line 1. 


The FINIS operand causes MYFILE DATA to close. Therefore, any 
Subsequent DISKR operation using a default linenum value would begin 
reading at line 1. 


FIND 
LOCATE 
AVOID options 


The delimiter pair for the specified character string need not he / /. 
They may be any character not included in the string. For example: 


EXECIO * DISKR MYFILE DATES (LOCATE $12/25/81$ 


FIFO 
LIFO options 


Most EXECIO operations that write to the program stack default to FIFO, 


first line written to the stack will be the first read out. The 
exceptions (LIFO) are operations involving a search (LOCATE, FIND, and 
AVOID options). These operations result in the relative line number 


(number of lines read to satisfy the search) being stacked. For DISKR 
operations the absolute line number (position from the top of file) is 
also stacked on the same line. It is necessary to have these numbers at 
the top of the stack so that they are immediately accessable to a 
subsequent EXECIO command. 


SKIP option 
On EXECIO read operations the SKIP operand prevents input lines fron 


being written to the program stack. For example, you might want to put 
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on the program stack all lines of MYFILE DATA that follow the line 
containing '4120 Rock Road'. First, to search through the file for the 
line after which reading to the program stack is to begin, issue: 


EXECIO * DISKR MYFILE DATA * 1 (LOCATE /4120 Rock Road/ SKIP 


The SKIP option prevents the line being searched for, together with the 
line number, from being written to the program stack. .Then, to write to 
the program stack the next line through the end of file, issue: 


EXECIO * DISKR MYFILE DATA 


Keep in mind that accessing MYFILE DATA by another program or causing a 
CMS READY message to be displayed prior to isSuing the second EXECIO 
command would change the point at which the second command begins 
reading. When possible, you _ should specify the linenum operand 
explicitly. 


Another use of the SKIP option might be the execution of a CP command 
via the CP operand to obtain a return code without displaying the 
resulting messages or writing them to the program stack. For example: 


EXECIO * CP (SKIP STRING Q userid 
The userid must be uppercase. 


As an alternative, specifying 0 for the "lines" operand value with the 
CP operand also causes results not to be displayed or written to the 
program stack. 


Using EXECIO in EXEC 2 execs 


This example is not intended to teach you all you need to know to write 
EXEC 2 execs. If you are not already familiar with EXEC 2, see VM/SP 
EXEC 2 Reference. 


The example illustrates how you might use EXECIO commands in an EXEC 2 
exec to read a CMS file from the program stack, then print that file, 60 
lines per page, with the cutput indented 15 spaces. 


This is not the only, nor necessarily the best way to accomplish the 
results. However, it does show some uses of the EXECIO command within 
an EXEC 2 exec. The exec statement numbers in the left margin are to 
reference explanations below, and are not a part of the exec. 
Indentation of statements is only to identify groups that make up 
routines within the exec. 


Because the exec reads, prints, and indents, lets name it RDPRIND EXEC 
(the filetype must be EXEC). 


RDPRIND EXEC 


1. &TRACE 

26 &CASE M 

3. &UPPER ARGS 

4. DROPBUF 0 

5. &B = &LEFT OF &BLANK 15 
6. EL = 0 

Te EXECIO 1 PRINT (CC 1 STRING 
8. -AGAIN 

9. EXECIO 100 DISKR &1 &2 &3 
10. &TEST = ERC 

11. SENTRIES 
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12. 
13. 
14. 
15. 
16. 
17. 
18. 
19. 
20. 
21. 
22. 
23. 


&LOOP -END &RC 

&READ STRING &S 

&S = &CONCAT OF &B &S 
EXECIO 1 PRINT (STRING &S 
&6&L = &L + 1 

SIF &L < 60 &GOTO -—END 
EXECIO 1 PRINT (CC 1 STRING 
&L = 0 

-~ END 

SIF &TEST = 0 &GOTO —-AGAIN 
CP CLOSE PRT NAME &1 6&2 

& EXIT 


(Explanations, by statement number) 


1. 


2. 


10. 


11. 


STRACE - EXEC 2 execs begin with an &TRACE statement (to distinguish 
them from CMS execs). 


SCASE M —- Input characters, resulting from subseguent exec statements 
causing read operations, are not to be translated to uppercase (the 
default condition). 


SUPPER ARGS - Command line arguments are processed in uppercase. 
This statement caused any arguments entered in lowercase to be 
translated to uppercase. 


DROPBUF O - Clears the program stack of any existing lines. 


6B = &LEFT OF &BLANK 15 - Creates a variable (&B) that is 15 blank 
(GBLANK) characters and begins at the left margin (&LEFT OF). This 
is used to indent printed output 15 positions. 


&L = 0 - Initialize to 0 the variable (&L) used to count the number 
of lines printed on the current page. When this number’ reaches 60 
the exec causes a page eject. 


EXECIO 1 PRINT (CC 1 STRING - Cause the printer to eject to the top 
of a new page (CC 1) before the first line is printed. Because no 
lines are to print on this particular operation, the dummy STRING 
operand is included to prevent reading a line from the program stack 
or the console. 


-AGAIN - Marks the start of the read/print routine. 


EXECIO 100 DISKR &1 &2 &3 - The input file is to be read 100 lines 
each time through this loop until an end of file condition occurs. 
This is because some files may be so large that stacking space 
becomes a problen. If you are certain that the entire file can be 
handled on one DISKR operation, you can specify * in place of the 100 
for a ‘lines' operand. 


&TEST = &RC - Set the variable &TEST to the value of the return code 
from the EXECIO DISKR operation. A QQ return code indicates that 
more lines remain to ke read. 6&TEST is checked at statement 21 to 
determine if the last group of lines from the file have been read, 
resulting in an exit from the exec. 


SENTRIES - The return code from this CMS command is egual to the 
number of lines on the program stack. Because 100 lines are read on 
the DISKR operation, this number will be 100, except for the final 
DISKR operation, when the number will probably be something less 
than 100. This number is used at statement 12 to set up the number 
of times to loop through the print routine. 
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{| 14. 


{ 15. 


| 16. 


18. 


1 19. 
1 20. 


21. 


{ 22. 


| 23. 


| Now, 
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&LOOP -END &RC - Loop through the following routine (to -END) a 
humber of times equal to the number of lines on the program stack 
(GRC). One file line is printed each time through the loop. 


&READ STRING &S — Read a line from the program stack and assign the 
string of characters read as the value of variable 6&S. 


&S = §&CONCAT OF &B &S - Concatnate 15 blanks (&B, assigned in 
statement 5) to precede the line just read (&S). 

EXECIO 1 PRINT (STRING &S - Print one line, the characters of which 
are the value of &S. Because no CC operand is specified, single 


spacing follows. 


&L = &L + 1- Add one to the variable (&L) that counts the number of 
lines printed on the current page. 


SIF &L < 60 &GOTO -END - If 60 lines have not yet printed on this 
page (value of &L less than 60), bypass next two statements. 


EXECIO 1 PRINT (CC 1 STRING - Eject the printer form to the top of a 
hew page (Similar to statement 7). This statement is executed when 
printed line counter advances to 60 (condition in statement 17 not 
satisfied). 

&L = 0 - Reset printed line counter to begin new page. 

-END - This label marks the end of the print routine loop. 

&IF ETEST = 0 &GOTO -AGAIN - If the return code from the previous 
EXECIO DISKR operation (&RC now saved in &TEST) is not 0 (no end of 
file condition), branch back to -AGAIN to read and print another 
group of lines. 


CP CLOSE PRI NAME &1 &2 - Close the printer spool file, and assign 
it the same filename (&1) and filetype (&2) as the disk file read. 


SEXIT - Returns control to CMS. 


to cause the exec to read and print a CMS disk file named TESTFILE 


| DATA A, issue: 


RDPRIND TESTFILE DATA A 


| TESTFILE, DATA, and A are substituted into the exec for 6&1, &2, and &3 
| respectively. 


| Messages and Return Codes 


| DMSEIO618E NUCEXT FAILED RC=13 


| DMSEIO621E BAD PLIST: EXECIO MUST BE INVOKED AS A NUCLEUS 


EXTENSION k&C=24 
BAD PLIST: DISK argument ARGUMENT IS MISSING RC=24 
BAD PLIST: INPUT FILE "fileid™ DOES NOT EXIST RC=24 


BAD PLIST: INVALID POSITIONAL ARGUMENT (argument) RC=24 
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DMSEIO622E 


DMSEIO632E 


BAD PLIST: 
BAD PLIST: 


BAD PLIST: 
RC=24 


BAD PLIST=: 
OPTION 


BAD PLIST: 
OPERATION 


BAD PLIST: 


FOR CP OPERATION 


BAD PLIST: 
RC=24 


BAD PLIST: 
RC=24 


BAD PLIST: 
BAD PLIST: 


BAD PLIST: 
RC=24 


BAD PLIST: 


BAD PLIST: 


RC= 


UNKNOWN OPTION NAME (name) RC=24 


VALUE MISSING AFTER option OPTION RC=24 


VALUE (value) NOT VALID FOR option OPTION 


option OPTION IS NOT VALID WITH option 
24 


option OPTION NOT VALID WITH operation 
RC=24 


STRING OPTION WITH LINES=* IS VALID ONLY 
RC=24 


DEVICE AND LINES ARGUMENTS ARE REQUIRED 


INVALIDT VALUE (value) FOR NUMBER OF LINES 


MISSING "DEVICE" ARGUMENT RC=24 


INVALID "DEVICE" ARGUMENT (argument) RC=24 


INVALID VALUE (value) FOR DISK FILE LINE NUMBER 


DISK FILEMODE REQUIRED FOR DISKW RC=24 


INVALID RECORD FORMAT (recfm) -- MUST BE 


EITHER F OR V- RC=24 


BAD PLIST: 
RC=24 


BAD PLIST: 
AGREE WITH 


BAD PLIST: 


WITH EXISTING FILE LRECL (lrecl) 


BAD PLIST: 


INVALID RECORD LENGTH ARGUMENT (lrecl) 


FILE FORMAT SPECIFIED 
EXISTING FILE FORMAT 


(cecfm) DOES NOT 
(crecfm) RC=24 


FILE LRECL SPECIFIED (lrecl) DOES NOT AGREE 


RC=24 


EXECIO OPTIONS ONLY ALLOWED WITH EXTENDED 


PLIST RC=24 


BAD PLIST: 


BAD PLIST: 


INVALID MOLE 'mode® RC=24 


INVALID CHARACTER IN FILE IDENTIFIER RC=24 


INSUFFICIENT FREE STORAGE FOR EXECIO kC=41 


I/O ERROR 
COMMAND 


IN EXECIO: RC='return code! FROM ‘command' 


RC=1nn 
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FLOLSHGd COLESCULY oc 6 cdo owe eee wices oe 6b eo eee cee ee ee cas 
TEUNCA CCE 6.0 cide ewes Aes oe ee ew eee ok ww ee SS wie Swe Se os one seers 
EOF before specified number of lines were read ........ 
Count ran out without successful fattern match ........ 
NUCEXT initialization failed wncccwscaccscccccccccccccecs 
Bad, PLUS: saced:e.0e 6 ee teces oe aes eal ai woe ore ees woe ewe aie Slee wee es 
Insufficient free storage to load EXECIO .............. 
100 + return code from I/O operation (if nonzero) ..... 
1000 + return code from CP command (if nonzero), 
where x is 0, 1, 2, or 3, as described above ... 
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FETCH 
FETCH 


Use the FETCH command in CMSyDOS to load an executable phase 
into storage for execution. The format of the FETCH command is: 


a ca re ne ea a eae 
FETCh | phasename_ [ (options...[) ]] 

| options: 

l [START ] 

| [COMP ] 

i [ORIGIN hexloc ] 


a Se CN Ce ne 


where: 


phasename is the name of the phase to be loaded into virtual storage. 
CMS searches for the fhase: 


e Ina VSE private core image jlibrary, if IJSYSCL has been 
defined 


e In CMS DOSLIEsS that have been identified with the GLOBAL 
command 


e In the VSE system core image library, if you specified the 
mode letter cf the VSE system residence on the SET DOS ON 
command line 


Qptions: 


START- specifies that once the phase is loaded into storage, 
execution should begin immediately. 


COMP specifies that when the phase is to be executed, register 1 
should contain the address of its entry point. (See Usage 
Note 5.) 


ORIGIN hexloc 
fetches the program and loads it at the location specified by 
hexloc; this location must ke in the CMS user area below the 


start of the CMS nucleus. The location, hexloc, is a 
hexadecimal number of up to eight characters. (See Usage Note 
6.) 


Usage Notes 


1. If you do not use the START cption, FETCH displays a message at 
your terminal indicating the name of the phase andthe _ storage 
location of its entry point. At this time, you can set address 
instruction stops for testing. To continue, issue the START 
command to initiate execution of the phase just loaded. 


2. The fetch routine is alsc invoked by supervisor call (SVC) 
instructions 1, 2, 4, or 65. The search order for executable 
phases is the same as listed akove. 


3. If you want to fetch a phase from a private core image library, you 
must issue an ASSGN command for the logical unit SYSCLB and define 
the library in a DLBL ccmmand using the ddname IJSSYCL. FOr 
example; 
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assgn sysclb c 
dlbl ijsyscl c dsn core image lib (sysclb perm 


4. Phases fetched from VSE core image libraries must have been 
link-edited with ACTION REL. 


S5.- CMS uses the COME option when it fetches the DOS PL/I compiler 
because that compiler expects register 1 to contain its entry point 
address. This option is net required when you issue the FETCH 
command to load your own programs. 


When CMS starts executing a phase that has COMP specified, the 
DMSLIO740OI EXECUTION BEGINS... message is not displayed. 


6. The ORIGIN option is used by the VSAMGEN installation EXEC 
procedure to load nonsharatle modules on a segment boundary. It is 
not required when you issue the FETCH command to load your own 
programs, unless you want to load them at a location other than 
20000. 


7. %QThe FETCH command should only be used with the START command to 
execute a VSE progran. It should not be used with GENMOD to 
attempt to create an executable CMS module file. 


8. Multiphase program support is different in CMS/DOS than in VSE. 
The core image directory is not searched for multiphase programs. 
Thus the value of HIPROG in BGCOM reflects only the ending address 
of the longest phase loaded, not that of the phase in the library 
that has the highest ending address. 


Responses 
DMSFET710I PHASE "phase ENTRY POINT AT LOCATION xxxxxx 


This message is issued when the START option is not specified. It 
indicates the virtual storage address at which the phase was 
loaded. 


DMSLIO74OI EXECUTION BEGINS... 


This message is issued when the START option is specified; it 
indicates that program execution has begun. 


Other Messages and Return Codes 

DMSFCH104S ERROR ‘nn* READING FILE ‘fn ft fm" FROM DISK RC=100 

DMSFCH109S VIRTUAL STORAGF CAPACITY EXCEEDED RC=104 

DMSFCH113S DISK (cuu) NOT ATTACHED RC=100 

DMSFCH115E PHASE LOAD POINT LESS THAN ‘address* RC=40 

DMSFCH411S INPUT ERROR COLE "nn" ON * {SYSRES{SYSCLB}'° RC=100 

DMSFCH623S PHASE CANNOT BE LOADED AIT LOCATION "location BECAUSE IT 
WOULD OVERLAY THE CMS NUCLEUS RC=88 

DMSFCH777S DOS PARTITION TOO SMALL TO ACCOMMODATE FETCH REQUEST RC=104 

DMSFETOO3E INVALID CPTION "option! RC=24 

DMSFETOOYE PHASE 'phase* NOT FOUND RC=28 

DMSFETO29E INVALID PARAMETER ‘'parameter' IN THE OFTION "ORIGIN! FIELD 
RC=24 

DMSFETO7OE INVALID PARAMETER 'parameter' RC=24 

DMSFETO9S8E NO PHASE NAME SPECIFIED RC=24 

DMSFETOS9E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 

DMSFET623S PHASE CANNOT BE LOADED AT LOCATION "location! BECAUSE IT 
WOULD OVERLAY THE CMS NUCLEUS RC=88 

DMSLIOO55E NO ENTRY POINT DEFINED kRC=40 
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Use the FILEDEF command to establish data definitions for OS ddnames, to 
define files to be copied with the MOVEFILE command, or to override 
default file definitions made by the assembler and the OS_ language 
processors. The format of the FILEDEF command is: 


r 1 
|BLOCK nnnnn | ([SEMBER nembernane ] 
| 


|BLKSIZE nnnnn| [CONCAT] 
J 


u 


F | 
|DSORG (PS)| 
f rot 
| DA) | 
L 


J 


|FIledef| - al 
[ | | (ddnane Terminal [ (optionA optionD[) }] il 
[ [ I< nn i! 
| { rf PRinter [ (optionA OPTCD j[) }] ii 
[ I | ii 
| | | PUnch { (optional) }] TH 
l i | il 
| 1 | Reader | 
| i | r ro4 il 
[ i | DISK [fn ft [fm[| [ (optionA optionB[) ]] 1 | 
| | [FILE ddpame |A1lI| ll 
I I | . Te oe il 
l I | or i | 
[ I | r af ll 
| 1 | Ire aroa41 iil 
| _ [| {DISK f£n ft {Jfm] | (DSN ? iil 
| | | iil FILE ddnane||Ail\| {psa quall gual2 1 | 
[ i | [i Il ol (DSN gualt.qual2 ...-JIU Il 
| | | pee Jt 44 if it 
| i | ; Hil 
1 | | [ (optionA optionB[) J] Hu 
[ | | = JT il 
| 1 | DUMMY [ (optiona[) }] il 
l [ | il 
; | | r 7 il 
i i | TAPn |LABOFF ; il 
[ [ | 53 [nj i i 
| 1 | ISL [n] [VOLID volid] [DISP MOD] | | 
{ 1 | |SUL [n] [VOLID volid] ; il 
I | | [NL [n] A I 1 
| 1 | |NSL filename ( i 
| | | . i | 
| i | {[ (optionA optionC optionE[) J] 11 
| i | GRAF cuu [ (optionaA[) ]] i | 
| 1 | CLEAR ii 
| i & 4 | 
| | optionA: optionB: optionc: optionD: | 
| | [PERM] [KEYLEN nnnj r 1 r 1 | 
[ Ir 1 cr 1 | 7TRACK | [UPCASE | | 
{ | | CHANGE | |XTENT nnonn| | STRACK | | LOWCASE | | 
| | | NOCHANGE | [XTENT 50 | L 4 L 4 | 
| ; t 4 L 4 [TRICH a] 
| | [RECFM a] [LIMCT nun} [DEN den] optionE: [ 
| | [LRECL nnonnn ]j [OPTCD a] [ LEAVE ] [ 
| | [DISP MOD] [ NOEOV ] [ 
| | l 
| ! | 
[ i [ 
| | [ 
; I d 
I | i 
I [ [ 
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Devices 
TERMINAL 
PRINTER 
PUNCH 


READER 


DISK 


DUMMY 


TAP[ nj 


GRAF 
cuu 


CLEAR 


FILEDEF 


is the name by which the file is referred to in your 
program. The ddname may be from one to eight alphameric 
characters, but the first character must be alphabetic or 
national. If a number nn is specified, it is translated to a 
FORTRAN data definition name of FInnF001. An asterisk (*) may 
be specified with the CLEAR operand to indicate that all file 
definitions not entered with the PERM option should be 
cleared. 


is your terminal (terminal I/O must not be blocked). 
is the spooled printer. 
is the spooled punch. 


is the spooled card reader (card reader I/O must not be 
blocked). 


specifies that the virtual I/0 device is a disk. As shown in 
the format, you can choose cne of two forms for specifying the 
DISK operand. Both forms are described in "Using the FILEDEF 
DISK Operand." 


indicates that no real I/O takes place for a data set. 


is a magnetic tape. The symktolic number of the tape drive, n, 
can be 1, 2, 3, or 4, representing virtual units 181, 182, 
183, and 184, respectively. If nis not specified, FILEDEF 
uses the existing TAPn device for the specified ddname. TAP 
defaults to TAP2 if there is no existing definition for the 
specified ddname, or if the existing device was not TAPn. You 
can also specify the type of label processing you want on your 
tape. Specifying label processing is discussed in "Using the 
FILEDEF TAPn operand." 


Specifies that the virtual I/O device is a Graphic Display. 

is the virtual device address of the attached graphic display. 
removes any existing definition for the specified ddnane. 
Clearing a ddname before defining it ensures that a file 


definition does not exist and that any options previously 
defined with the ddname no longer have effect. 


Section 2. CMS Commands 123 


FILEDEF 


Options: Whenever an invalid option is specified for a particular 
device type, an error message is issued. Figure 9 shows’ valid 
options for each device type. ) 


TTRACK, QOTRACK 


|2No options may be necessary but all disk options are accepted. 
|*?This option is meaningful only for BDAM files. 

|3?This option is for 7-—track tapes only. 

|*This option is for SL tapes only. 

|SThis option is for Printer only. 

a i 
Figure 9. Valid File Characteristics for Each Device Type of the 
FILEDEF Command 


re re et ee ry ees ee ee Core eT a eee te ge eT aE Noe ee ee Tee ee eee ge Ce fet ee eT ee el 
| OPERANDS| i | | 
| | READER, | l i l { 
| Options | PUNCH, | | DISK | | 
| | PRINTER | TERMINAL | TAPn | DUMMY2 | GRAF | 
———__-_---_____— 
| BLOCK, BLKSIZE | x l x l xX | xX | | 
| CHANGE, NOCHANGE| X l X i} x | x ; x | 
| CONCAT | | | l X l i 
| DEN | { i X | | i 
| DISP MOD | | | x* | xX | 
| DSORG l [ | 4 Xx | H 
| KEYLEN | { [ l X2 | | 
| LEAVE I H [ X [ [ [ 
| LIMCT | l l l X2 [ [ 
| LOWCASE, UPCASE | x | | | | 
| LRECL r X | x 1 x | | 
| MEMBER | | l i x [ i 
| NOEOV l pe | | Xx l l f 
| OPTCD | | | [ x2 | l 
| PERM | X | x r x | Xx 1 x | 
| RECFM x | X 1 x | X | | 
| TRICH ; | { xs | l l 
| XTENT | | l l x2 i | 
| | | { l ( | 
I i 

l 

[ 

[ 

[ 

| 


PERM retains the current definition until it either is 
explicitly cleared or is changed with a new FILEDEF 
command with the CHANGE option. If PERM is not 
specified, the definition is cleared when a FILEDEF * 
CLEAR command is executed. 


CHANGE merges the file definitions whenever a file definition 
already exists for a ddname and a new FILEDEF command 
specifying the same ddname is issued; the options 
associated with the two definitions are merged. Options 
from the original definition remain in effect unless 
duplicated in the new definition. New options are added 
to the option list. 


NOCHANGE retains the current file definition, if one exists, for 
the specified ddname. With this option, the system stops 
further processing (error checking, scanning, etc.) of 
the new FILEDEF command if a file definition exists for 
the specified ddname. 
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RECFM a is the record format of the file, where "a" can be one of 
the following: 


a Meaning 

F fixed length 

FB fixed blocked?! 

V variable length 

VB variakle blocked?! 

U undefined 

FS,FBS fixed length, standard blocks 
VS, VBS variable length, spanned records 
A ASA print control characters? 

M Machine print control codes? 


LRECL nnnnon is the logical record length (nnnnn) of the file, in 
bytes. LRECL should not exceed 32760 bytes because of O05 
restrictions. 


BLOCK nonnn 

BLKSIZE nnnnn 
is the logical block size (nnnnn) of the file, in bytes. 
BLOCK should not exceed 32760 bytes because of OS 
restrictions. If both BLOCK and BLKSIZE options are 
specified, the value of nnnnn for BLOCK is used and 
BLKSIZE is ignored. 


KEYLEN non is the size (nnn) of the key (in bytes). The maximum 
value accepted is 256. 


XTENT nnnonn is the numker of records (nnnnn) in the extent for the 
file. The default is 50. The maxinun value is 
16,777,215. 


LIMCT nnn is the maximum number of extra tracks or blocks (nnn) to 
be searched. The maximum value is 256. 


OPTCD a is the direct access search processing desired. The 
variable "a" may be any comkination of up to three of the 
following: (A and R are mutually exclusive.) 


Code DAS Search 


A Actual device addressing 

E Extended search 

F Feedback addressing 

R Relative block addressing 
OPTCD j is valid only for the Printer. 


J When the virtual printer is a 3800, ‘J indicates 
to QSAM and BSAM that the output line contains a 
TRC (Table Reference Character) byte. 


Note: The KEYLEN, XTENT, LIMCT, and OPTCD options should only be used 
with BDAM, QSAM, or ESAM files. 


DISP MOD positions the read/write pointer after the last record in 
the disk file. This option should only be used for 


1FB and VB should not be used with TERMINAL or READER devices. 
2A and M may be used with any of the valid RECFM settings (for example, 
FA, FBA, VA, VBA, etc.) M should not be used with TERMINAL devices. 
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adding records to the end of a file. When adding records 
to the end of a file, the file must be on a disk accessed 
as read/write. If adisk is an extension of another 
disk, the extension is automatically read/fonly and you 
cannot write to it. DISP MOD may be used to add records 
to the end of the tape file only for standard label 
tapes. 


MEMBER membernane 


CONCAT 


DSORG (PS 
PO 
DA 


7TRACK 
O9TRACK 


C=_—- 4 
a | 


TRICH a 


DEN den 


LOWCASE 


LEAVE 


NOEOV 


allows you to specify the name of a member of an OS 
partitioned data set; membername is the name of the PDS 
member. 


allows you to assign the same ddname to two or more OS 
libraries so that you can refer to them ina single 
GLOBAL command. You may concatenate libraries with 
filetypes of MACLIB and LOAILIB. 


Any file format options you specify in the first FILEDEF 
connand line remain in effect for subsequently 
concatenated libraries. For a detailed description of 
concatenated macro libraries, see "Using OS Macro 
Libraries" in VM/SP CMS User's Guide. 


is the data set organization: physical sequential (PS), 
partitioned (PO), or direct access (DA). 


is the tape setting. The tape device mode is not checked 
or set by filedef. Use the TAPE command MODESET option to 
set the mode of a tare. 


is the tape recording technique for 7-track tapes. Use 
the following chart to determine the value of "a" for 
7-track tapes. 


ee ee aoe ge eee ey ee Se pe ee en ee ee a a ee ee ee 


| a | Parity | Converter | franslator | 
| i 
; o | odd | off | off | 
} oc | odd ( on | off | 
| oT | odd | off | on | 
| E | even | off | off | 
| ET | even | off | on | 


The default value of TRICH is OC. 


is tape density: den can be 200, 556, 800, 1600, or 6250 
bpi (bits per inch). If 200 or 556 are specified, 7TRACK 
is assumed. If 800, 1600, or 6250 are specified 9TRACK is 
assuped. 


translates all terminal input data to uppercase. 

retains all terminal input data as typed in. 

is only valid for TAPn files that are SUL or SL (standard 
label). With this option selected, the tape is not noved 
before lakel processing. If LEAVE is not’ specified, 
tapes with files specified as SL or SUL are rewound and 
then positicned before the files are processed. 


is only valid for TAPn files. With NOEOV selected, there 
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is no automatic limited end-of-volume processing when end 
of tape is sensed on output. See the section "CMS Tape 
Label Processing" in the VM/SP CMS User's Guide fora 
description of end-of-volume processing. 


Usage Notes 


ii 


If you do not issue a FILEDEF command for an OS input or output 
file, CMS uses the ddname on the DCB macro to issue the following 
default file definition: 


FILEDEF ddname DISK FILE ddnane At 


See "Usage Notes" under the discussion of the ASSEMBLE command for 
information on the default file definitions made by the assenbler. 


To identify VSE files for VSE program execution or to identify VSAM 
data sets for either OS or VSE program execution, you must use the 
DLBL command. ; 

A file definition established with the FILEDEF command remains in 
effect until explicitly changed or cleared. The system clears file 
definitions under the following circumstances: 


e When the assembler or any of the language processors are 
invoked. (Note that FILEDEF definitions entered with the PERM 
option are not cleared.) 


e When a program abends or when you issue the Immediate command HX 
to halt command or program execution. 


The FILEDEF command does not supply default values for ILRECL and 
BLKSIZE. As under OS, if DCB information is unavailable when a 
file is opened, an open error is issued for the file. The 
following chart summarizes the results at OPEN time of specifying 
LRECL and BLKSIZE options. 


a a ee aa ee ee ee ee EN ee ee ee ae ee gee 
| BLKSIZE | LRECL | Results | 
| -—________—_--_——_- : | 
| Not | Not JIf the input file exists on disk, the | 
| Specified | Specified |item length (or item length +4 for vari- | 
i | jable—length records) becomes the BLKSIZE. | 
i 

| Specified | Not {| LRECL=BLKSIZE (or LRECL=BLKSIZE—-4, for | 
{ | Specified |variable-length records). | 
| | 
| Not | Specified |{BLKSIZF=LRECL (or BLKSIZE=LRECL+4, for | 
| Specified | |variakle—length records). | 
; l 
| | 


Specified | Specified |The values specified are used. 
a a a a a ce ee eee 


If V or VB is specified for RECFM, LRECL must be at least 4 bytes 
less than BLKSIZE and LRECL must be at least 4 bytes greater than 
the largest record of the file. 


VSE sequential (SAM) files do not contain BLKSIZE, LRECL, or RECFM 
specifications. These options must be specified by a FILEDEF 
command or DCB statement if OS macros are used to access VSE files. 
Otherwise the defaults, BLKSIZE=32760 and RECFM=U, are assumed. 
LRECL is not used for RECFM=U files. 


There is an auxiliary processing option for FILEDEF that is only 
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valid when FILEDEF is executed by an internal program call: this 
option cannot be entered as a terminal command. The option, 
AUXPROC addr, allows an auxiliary processing routine to receive 
control during I/0 operations. For details cn how to use this 
option of the FILEDEF command, see VM/SP System Programmer's Guide. 


6. If a FILEDEF command is issued with a DDNAME that matches a current 
DDNAME defined by a previous FILEDEF command and the devices are 
the same, the filename, filetype, filemode, and options previously 
specified remain in effect, unless respecified by the new FILEDEF 
command. If the devices are not the same, all previous 
specifications are removed. 


7. If the FILEDEF command is entered with no operands, alist of 
current definitions is displayed. 


Using the FILEDEF DISK Operand 


There are two general forms for specifying the DISK operand in a FILEDEF 
command. If you specify the first form: | 


FILEDEF ddname DISK fn ft [fn] 


fn and ft (filename and. filetype) are assumed to be a CMS fileid. If fn 
is the filemode of an OS disk, fn and ft are assumed to be the only two 
qualifiers of an OS data set name. if fm is specified as an asterisk, 
(*) then all accessed disks are searched. 


You cannot use this form unless the OS data set name or VSE file-id 
conforms to the OS naming convention (1- to 8-byte qualifiers separated 
by periods, to a maximum of 44 characters, including periods). Also, 
the data set name can have only two qualifiers; otherwise, you must use 


the DSN ? or DSN quali... form. For example, if the OS data set nane 
or VSE file-id is TEST.SAMFLE.MAY, you enter: 


FILEDEF MINE B1 DSN TEST SAMPLE MAY 
a OF =< 
FILEDEF MINE B1 DSN TEST.SAMPLE. MAY 
-- or -- 


FILEDEF MINE B1 DSN ? 
TEST.~SAMPLE.MAY 


If the OS data set name or VSE file-id is TEST.SAMPLE, then you may 
enter: 


FILEDEF MINE DISK TEST SAMPLE B1 


The second form of the DISK operand is used only with OS data sets 
and VSE files: 


- 
FILEDEF ddname |DISK fn ft 

FILE ddname 
DSN quali [.qual2... ] 


es me es em 


a 
| fn 
jA1 
1 
L 


ben es ee 


DSN ? 
{ DSN quali [gqual2... ] 
l 
L 
This form allows you to to enter OS and VSE file identifications that do 
not conform to OS data set naming conventions. The DSN operand 


corresponds to the DSN parameter on the OS DD (data definition) 
statement. There are three ways you can specify this forn: 
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e FILEDEF ddname DISK fn ft fm DSN quall [qual2... ] 
e FILEDEF ddname DISK fn ft fm CSN guall [-qual2... ] 


This form of the FILEDEF command associates the CMS filename and 
filetype you specify with the OS data set name or VSE file-id specified 
following the DSN operand. Once it is defined, you can refer to the OS 
data set name or VSE file-id by using the CMS filename and filetype. If 
you omit DISK, filename, filetype, and filemode, the default values are 
FILE ddname Al. 


e FILEDEF ddname DSN ? 


This form of the FILEDEF command allows you to specify the OS data 


set name or VSE file-id interactively. Using this form, you can 
enter an OS data set name or VSE file-id containing embedded special 
Characters such as blanks. If you use this form, the default 


filename and filetype for your file, FILE ddname, is the CMS filename 
and filetype associated with the OS data set name or VSE file-id. 
The filemode for this form is always the default, A1. 


To use the interactive DSN operand, you key in DSN ?; CMS then 
requests that you enter the OS data set name or DOS file-id exactly 
aS it appears in the data set or file. Do not omit the periods that 
separate the qualifiers of an OS data set name, but do not insert 
periods where they do not appear. 


quall{.qual2... ] 


where gquali.gqual2... are the qualifiers of the OS data set name or 
VSE file-id. When you use this form, you must code the periods 
separating the qualifiers. 


e FILEDEF ddname mode DSN quali [qual2... ] 
e FILEDEF ddname mode DSN guall [.gual2... ] 


This form allows you to specify the OS data set name or VSE file-id 
explicitly. The default value for the filename and filetype is FILE 
ddname. When you use this form, you can use periods to separate the 
qualifiers or you can omit the periods. If the command is entered 
with a blank separating the qualifiers, FILEDEF replaces them with 
periods. For example, for an OS data set or VSE file named 
MY.FILE.IN, you enter: 


FILEDEF ddname B1 DSN MY FILE IN 
ee. 
FILEDEF ddname B1 DSN MY.FILE.IN 
All of these forms have many variations, as iS apparent from the 


command format. 


Using the FILEDEF TAPn Operand 

When you define a tape file with the FILEDEF command, you can specify 
the type of label processing tc be done for the file. You do this by 
specifying a second operand after the word TAPn. The operands that you 
may specify and their meanings are: 
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LABOFF indicates that there is no CMS tape label processing for this 
tape file. LABOFF is the default. The tape is not positioned 
if this operand is specified. 


BLP indicates that the system is to bypass label processing but 
that the tape is to be positioned before the file is processed. 


SL indicates that ycu are using IBM standard labels. 


SUL indicates that you are using Standard user labels (not 
processed for MOVEFILE). 


NL indicates that your tape has no IBM standard labels. (Do not 
use this operand if your tape has a VOL1 label. A file on it 
will not be opened.) 


NSL indicates that you are using nonstandard labels. 
For the operands BLP, SL, and SUL: 


n indicates the position of the file on a multifile volume. When 
h is not specified, the default is 1. 


For SL and SUL files: 


volid specifies a 1- to 6-character volume serial number to be 
verified by reading the VOL1 label on the tape. If not 
specified in FILEDEF, volid may be specified ona LABELDEF 
command. If specified on both commands, the more recent 
specification is used. VOLID is only valid for SL or SUL tape 
files. If VOLID is not specified, the volume label on the tape 
is not checked. 


For SL files: 


DISP MOD The DISP MOD option may be used to add records to tape files 
only for standard label tapes: 


FILEDEF file a tap1 sl (disp mod 


when the file is opened (output), the tape is positioned at the 
end of the file, ready to add new records. 


For the NSL operand: 


filename is required for NSL files. It is the filename of a file that 
contains a routine for frocessing nonstandard labels. The 
filename must be that of a TEXT or MODULE file. If you have 
both a MODULE and TEXT file with this name, the MODULE file is 
used. MODULE files must be created so that they start at an 
address that does not allow them to overlay a user program if 
they are to ke used for NSL routines. See the section "Tape 
Labels in CMS" in the VM/SP CMS User's Guide. for details on 
writing routines to process nonstandard labels. 


You can define a file on tap2 with standard labels by using the 
following command: 


filedef filea tap2 sl volid depti10 


When this tape file is ofened, CMS checks to see that it has a VOL1 
label with a volume serial number of depti0. 


To specify the second file on the same tape, use 
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filedef filea tap2 sl 2 volid depti0 
The same file could te defined as having no labels by using 
filedef filea tap2 blp 2 filedef filea tap2 nol 2 


If you use the above specification, your tape must not contain IBK 
standard labels. NL causes CMS to read your tape when you try to open a 
file on it and checks to see if the tape contains a VOL1 label as its 
first record. If a VOL1 label is there, CMS does not open your tape 
file. 


If you specify 
filedef filea tap2 blp 2 


CMS positions the tape to the second file, but does not check to see if 
the tape has a label. 


Note: If you mount a Llank tape and specify NL, the tape will run off 
the end of the reel. Write a tape mark to prevent this from occurring. 


To define a tape file with nonstandard labels, use the following 
command: 


filedef filea tar2 nsl nonstd 


The routine NONSTD must exist as a TEXT or MODULE file and be able to 
process the particular nonstandard labels you are using for your tapes. 


If you defined filea with no label parameter at all, for example, 
filedef filea tar2 


there is no label procesSing or positioning before the data in filea is 
processed. 


When you use the options DEN, TRICH, /7TRACK or STRACK to set the mode of 
an output file, if the type of label processing is anything other than 
LABOFF (the default), the tape will be written at the current node of 
the tape drive and not the mode specified in the FILEDEF command. This 
is due to a hardware restriction which allows the mode of a tape drive 
to be reset only when the tape is at load point. If LABOFF is used, the 
tape will still be at the load point when the first record of the file 
is written, so the mode will be reset. See the CMS TAPE Command Usage 
Notes for more information. 


Read the section "Tape Labels in CMS" in the VM/SP CMS User's Guide 
before you write programs that handle labeled tapes. 


Use the LEAVE and NOEOV options for tape files only. 


LEAVE indicates that a tape containing standard-label files is not to be 
moved before label processing. Using this option prevents CMS fron 
rewinding the tape and checking the VOL1 label as it otherwise does for 
SL and SUL files. The command 


filedef fileb tapi sl (leave 


defines a tape file on tapel but tells CMS not to position the tape 
before processing the labels for fileb. Note that you must position the 
tape properly yourself before using the LEAVE option. LEAVE may be used 
with SL. SUL, and BLP. However, it has no effect if used with NL. NL 
tapes are always rewound and positioned before a file on them is opened 
(even if you specify LEAVE). 
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Use the LEAVE option with nmultifile volumes where rewinding and 
repositioning a tape before processing each file is inefficient. You 
must not move the tape between files if you use this option. Note that 
for BLP files you can obtain the effect of LEAVE by defining the file as 
LABOFF rather than BLP. 


Using NOEOV, CMS does not do any end-of-tape processing on output. If 
this option is not specified, CMS writes a tape mark after it encounters 
EOT on output and, for SL and SUL files, also writes an EOV1 label and 


another tape mark after the first tape mark. The tape is then rewound 
and unloaded. NOEOV suppresses this limited EOV processing. 


Responses 


If FILEDEF is entered with no operands and there are no filedefs in 
effect, the message: 


DMSFLD324I NO USER DEFINED FILEDEF'S IN EFFECT 
is displayed. 


If FILEDEF is entered with no operands and there are filedefs in effect, 
a list of current definitions is displayed. For example: 


ddnanme1 devicel ffilenamei filetypel filemodel [datasetnane ]} } 


ddnamen devicen [filenameN filetypeNn filemoden [ datasetnane ]} ] 

DMSFLDO69I DISK tmode* NOT ACCESSED 
The specified disk is not accessed; the file definition remains in 
effect. You should access the disk before you attempt to read or 
write the file. 

DMSFLD220R ENTER DATA SET NAME: 
A FILEDEF command with the DSN ? operand was entered. Enter the 
exact OS or VSE file identification, including embedded periods and 
blanks. 

DMSFLD7O4I INVALID CLEAR REQUEST 


A CLEAR request was entered for a file definition that does not 
exist; no action is taken. 


DMSSTT228I USER LABELS BYPASSED ON DATA SET ‘data set nane'* 
This message is displayed when you issue a FILEDEF command for an 
OS data set that contains user labels. The message is displayed the 


first time you issue the FILEDEF command after accessing the disk 
on which the data set resides. 
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Error Messages and Return Codes 


DMSFLDOO3E INVALID OPTION "option' RC=24 

DMSFLDO23E NO FILETYPE SPECIFIED RC=24 

DMSFLDO2Z7E INVALID DEVICE ‘device name* RC=24 

DMSFLDO29E INVALID PARAMETER ‘parameter' IN THE OPTION ‘option! FIELD 
RC=24 

DMSFLDO35E INVALID TAPF MODE RC=24 

DMSFLDO5OE PARAMETER MISSING AFTER DDNAME RC=24 

DMSFLDO65E ‘option! OPTION SPECIFIED TWICE RC=24 

DMSFLDO66E ‘option AND 'option® ARE CONFLICTING OPTIONS RC=24 

DMSFLDO7OE INVALID PARAMETER ‘parameter' RC=24 

DMSFLD221E INVALID DATA SET NAME ‘data set name® RC=24 

DMSFLD224E FILEID ALREADY IN USE RC=24 

DMSFLD324I NO USER DEFINED FILEDEFs IN EFFECT RC=0 

DMSFLD420E NSL EXIT FILENAME MISSING OR INVALID RC=24 
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Use the FILELIST EXEC procedure to display a list of information about 
CMS files residing on accessed disks. In the FILELIST environment, 
information that is normally provided by the LISTFILE command (with the 
DATE option) is displayed under the control of the System Product 
editor. You can use XEDIT subcommands to manipulate the list itself. 
You can also issue CMS commands against the files directly from the 
displayed list. 


The format of the FILELIST command is: 


FILEList |[fn [ft [fn]]}]]) [ (options...[) J] 
| options: 
| [Append] 
| [Filelist| Nofilelist ] 
| [PROFile fn] 


aw eee ee ee Oe 


where: 

fn is the filename of the file(s) for which information is to be 
collected. If an asterisk (*) is coded in this field, all 
filenames are used. 
Certain special ‘characters can be used as part of the filenane 
to request that the list contain a specific subset of files. 
See the usage note, "Pattern Matching", for more information 
On using these characters. 

ft is the filetype of the file(s) for which information is to be 
collected. If an asterisk is coded in this field, all 
filetypes are used. 
Certain special characters can be used as part of the filetype 
to request that the list contain a specific subset of files. 
See the usage note, “Pattern Matching", for more information 
on uSing these characters, 

fn is the filemode of the file(s) for which information is to be 


collected. If this field is omitted, only the A-disk is 
searched. If an asterisk is coded, all accessed disks are 
searched. 


If no operands are specified, the list contains all the files on your 
A-disk. (Issuing FILELISTI with no operands is like issuing "filelist * 
ok a.) 


Options: 


Append specifies that the list of files should be appended to the 
existing list. This option is meaningful only when issued 
from within the FILELIST environment. If issued outside of 
FILELIST, it results in an error condition. 


Filelist specifies that fn ft fm is a file that already contains a 
list of files, produced Ey an earlier invocation of FILELIST 
or LISTFILE (using the EXEC option). Information about each 
file in this list is displayed. 


If this option is specified, no special characters used for 


pattern matching may appear in fn ft or fm. For information 
on pattern matching, see the usage note, "Pattern Matching", 


134 IBM VM/SP CMS Command and Macro Reference 


FILELIST 


below. 


For information on creating and saving a list of files, see 
the usage note, "Saving a List of Files", below. 


Nofilelist specifies that fn ft fm is not a list of files. 


PROFile fn specifies the name of an XEDIT macro to be executed when 


XEDIT is invoked by the FILELIST command. If not specified, a 
macro named PROFFLST XEDIT is invoked. For more information 
on the PROFFLST macro, see the usage note, "Default PF Key 
Settings", below. 


Usage Notes 


1. 


3. 


Tailoring the FILELIST Command Options 


You can use the DEFAULTS ccmmand to set up options and/or override 
command defaults for FILELIST. However, the options you specify in 
the command line when entering the FILELIST command override those 
specified in the DEFAULTS command. This allows you to customize 
the defaults of the FILELIST command, yet override them when you 
desire. Refer to the DEFAULTS command description for more 
information. 


Pattern Matching 


You can use two special characters in the fn, ft, and fm operands 
to request that the file list ccntain a specific subset of files. 
The special characters are * (asterisk) and % (percent), where: 


* represents any number of character(s). AS many asterisks as 
required can appear anywhere in a filename or filetype. (Only 
one asterisk may be used for a filemode.) 


For example, if you enter: 
filelist *d* *file* 


you are requesting that the list contain all files on your 
A-disk whose filename contains "d" and whose filetype contains 
"file". The list might contain the following files: 


YOURDATA AFILE1 A 
HISDATA AFILE2 A 
ADOG 1DOGFILE A 
DATA FILE1 A 


% means any single character, but any character will do. As 
Many percent symbols aS necessary May appear anywhere ina 
filename or filetype. For example, if you enter: 


filelist %&K% stock 


you are requesting that the list contain all files on your 
A-disk whose filename is three characters in length and whose 
filetype is "stock". The list might contain the following 
files: 


THE STOCK A 
HIS STOCK A 
HER STOCK A 


Format of the List 
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When you invoke the FILELIST command you are placed in the XEDIT 
environment, editing a file “userid FILELIST A1". A sample 
FILELIST screen is shown in the "Examples" section. Each line in 
this file contains: 


e a command area 

e filename, filetype, filemode 

e format and logical record length of the file 

e number of records and number of blocks in the file 
e date and time the file was last written on the disk 


The full power of XEDIT is available to you while you issue 
commands against the list of files. For example, you may want to 
use XEDIT subcommands to scroll through the list of files, locate a 
particular file, etc. 


However, some XEDIT subcommands are inappropriate in this 
environment. Subcommands that alter the format or the contents of 
"userid FILELIST" (for example, SET TRUNC, SET FTYPE, or SET 
LINEND) may cause unpredictable results. 


Saving a List of Files 


You can save a list of files created by the FILELIST command simply 
by filing it, that is, issuing FILE or SAVE from the command line. 
Remember that the list is a file, whose filename is your userid and 
whose filetype is FILELIST. If you issue FILE or SAVE, the file 
"userid FILELIST" is kept until the next time you issue FILE or 
SAVE from the list. 


You can also save a particular file list by filing it under a 
different fileid. Cne way to do this is to issue the XEDIT 
Ssubcommand FILE from the command line, specifying a different 
filename and/or filetype. For example, you could issue "FILE MY 
FILES". Another way is to issue FILE from the command line, and 
then to use the CMS command RENAME. 


Saving a list of files is useful when you want to’ send nultiple 
files using the SENDFILE ccmmand. The list of files that you saved 
can be specified in the SENDFILE command issued with the FILELIST 
option. With this method, you can send multiple files by issuing 
the SENDFILE command only once. The only file identifier you have 
to keep track of is that of the list. For information on Sending a 
list of files, see the SENDFILE command (the description of the 
Filelist option). 


Issuing Commands From the List 


On a full screen display, you can issue commands directly from the 
line on which a file is displayed. You do this by moving the 
cursor to the line that describes the file to be used by the 
command, typing the command in the space provided to the left of 
the filename, and then pressing the PF10 key (not the ENTER key) to 
execute the command. 


If acommand is longer than the command space provided on the 
screen, just continue typing over the information in the line. You 
may type over the entire line displayed, up to column 79. 


The default setting of the PF10 key is EXECUTE, which is described 
below, under "Special Commands". When you press the PF10 key, all 
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| commands typed on one screen are executed, and the screen is 
[ restored to itsS previous state. However, the list is updated to 
[ reflect the current status of the files (see "Responses"). 


Pressing the ENTER key (or a PF key other than PF10) does not 


| 

| execute commands typed on the list. This allows you to move 
| through the list and to enter commands on different lines of the 
| list. 


| Another way to issue commands that make use of the files displayed 
| is to issue EXECUTE from the FILELIST command line. A complete 
| description of EXECUTE follows, in the section "Special Commands". 


| 6. Default PF Key Settings 
| The PROFFLST XEDIT macro is executed when the FILELIST command is 


| invoked, unless you specified a different macro as an option in the 
| .FILELIST command. It sets the PF keys to the following values: 


; PF 1 Help Display FILELIST command description. 

[ PF 2 Refresh Update the list to indicate new files, 

| erased files, etc., using the same parameters 
| as those specified when FILELIST was invoked. 
[ PF 3 Quit Exit from FILELIST. 

[ PF 4 Sort by filetype, filename. 

| PF 5 Sort by date and time, newest to oldest. 

| PF 6 Sort by size, largest first. 

| PF 7 Backward Scroll back one screen. 

| PF 8 Forward Scroll forward one screen. 

| PF 9 Fl/n Issue the command FILELIST /n * * at the cursor, 
| so that a list is displayed, containing 

[ all files that have the filename that is 

| displayed on the line containing the cursor 

| (all filetypes and filemodes). 

| PF 10 Execute Execute command(s) typed on the list. 

| PF 11 XEDIT Edit the file where the cursor is placed. 

| PF 12 Cursor Place cursor on current line. 


| Note: On a terminal equipped with 24 PF keys, PF keys 13 to 24 are 
| assigned the same values as PF keys 1 to 12 as discussed here. 


| Responses 


| When a command is executed, one of the following symbols is displayed in 
| the "Cmd" space to the left of the file for which the command was 
| executed. 


| * Means the command was executed successfully (RC=0). 

| *n Is the return code from the command executed (RC=n). 

| *? Means that the command was an unknown CP/CMS command (RC=-3). 
*! Means that the command was not valid in CHS subset. You are 


| 

| automatically placed in CMS subset mode if the editor is not 
| in the shared segment. For a list of commands valid in CMS 
| subset mode, see the VM/SP System Product Editor Command and 
| Macro Reference, the CMS subcommand description. 


| The following responses can also appear directly on the FILELIST screen: 
fname ftype fmode ** Not found. ** 


x 
| * No files match the search criteria: fname ftype fmode 
| * fname ftype fmode ** Discarded or renamed ** 
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Error Messages and Return Codes 


DMSWFLOO2ZE FILE ‘fn ft £m*' NOT FOUND. RC=28 
DMSWFLOO3E INVALID OPTION ‘option'. RC=24 
DMSWFLOSYE INCOMPLETE FILFIULD SPEICIFIFD. RC=24 
DMSWFLO7OE INVALID PARAMETER ‘parameter’. RC=24 
DMSWFL680E INVALID FILEID SPECIFIED WITH "FILELIST* OPTION. RC=20 
DMSWFL637E MISSING VALUE FOR THE "PROFILE! OPTION. RC=24 
DMSWFL651E ‘APPEND! MUST BE ISSUED FROM RDRLIST OR FILELIST. 
RC=40 
DMSSTTO62E INVALID CHARACTER ‘character! IN FILEID 'fn £t £fm*. 
RC=20 


Special Commands Used in the FILELIST Environment 

Two commands, EXECUTE and DISCARD, make use of the list of files 
displayed by the FILELISI command. EXECUTE can be used only in the 
FILELIST and RDRLIST command environments, while DISCARD can be used 
only in the FILELIST, RDRLIST, and PEEK command environments. 


EXECUTE 


Use EXECUTE (an XEDIT macro) to issue CP/CMS commands (or EXECs) that 
make use of files displayed by FILELIST. 


EXECUTE may be used in two ways. First, on a display terminal, the 
command(s) to be executed can be typed directly on the FILELIST screen 
and "EXECUTE" entered either on the command line or from a PF key (the 
default for the PF10 key in the FILELIST environment). Second, the 
command to be executed can be typed in the command line at the botton of 
the screen, following “EXECUTE" (as one of its operands). The command 
is then executed against one or more files in the list, beginning with 
the current line of the list. 


The format of the EXECUTE macro is: 


a aa a aaa a a RI a aaa a a a | 
| EXECUTE| [ Cursor|lines] [command] | 


Cursor means that a command is to be executed against the line that 
contains the cursor. The command can either be typed on the 
line that describes the file, or it can be typed as an operand 
of EXECUTE. The CURSOR operand is valid only on display 
terminals and is particularly useful when assigned to a PF 
key. For example, if EXECUTE CURSOR XEDIT is assigned to a PF 
key, you can place the cursor on the line describing the file 
you want to edit and then press the PF key. 


lines is the number of lines inthe file the command is to be 
executed for, starting with the current line of the list. If 
a command is specified, the default is one (1). You can 
specify an asterisk (*), which means “execute this command on 
all lines, from the current line to the end of the file". 


command is a CMS or CP command (or any program or EXEC) that makes use 


of files in the list. You can either type out the command 
Operands, or you can use the symbols described below to 
represent the filename, filetype, and/or filemode. (See the 
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usage note, "Using Symbols as Part of a Command".) 


Usage Notes 


1. 


Entering Commands on a Full Screen Display 


You can type commands that operate on files in the list directly on 
the lines of the FILELIST display. When you enter EXECUTE (either 
from the command line or by pressing the PF10 key), all commands 
typed on the lines in the file displayed on the current screen are 
executed. The filename, filetype, and filemode are appended 
automatically to the command, unless you typed one of the symbols 
described below (in usage note 3). 


Note that when a command is typed on the FILELIST or RDRLIST screen, 
EXECUTE rebuilds the line and compares it with the line displayed on 
the screen. The line is scanned from right to left, and the first 
character that is different signals the end of the command. 
Therefore, if the file information has been changed (as the result 
of a previous command), but this information has not yet been 
updated (by pressing PF2 to refresh the screen), EXECUTE wiil 
incorrectly interpret the information on the screen. An example 
follows. 


Sample FILELIST list: 


Cnd Filename Filetype Fm Format Lrecl Records Blocks Date Time 
CMS EXEC Al F 80 268 21 1/11/82 13:44:19 
TEST LIST Al F 80 22 2 1/11/82 13:19:29 


Issue COPYFILE command: 


Cnud Filename Filetype Fm Format Lrecl Records Blocks Date Time 
copyfile / test list a (APPEND 80 268 21 1/11/82 13:44:19 
TEST LIST Al F 80 22 2 1/11/82 13:19:29 


After pressing PF10 only the line with the command is refreshed: 


Cud Filename Filetype Fm Format Lrecl Records Blocks Date Tine 
* CMS EXEC Al F 80 268 21 1/11/82 13:44:19 
TEST LIST Al F 80 22 2 1/11/82 13:19:29 


Pressing PF2 updates the other files in the list: 


Cmd Filenane Filetype Fm Format Lrecl Records Blocks Date Tine 
TEST LIST Al F 80 290 23 «1/11/82 13:46:38 
CMS EXEC Al F 80 268 - 21 1/11782 132:44:19 
Entering Commands on the Command Line 


Another way to issue commands that make use of the files displayed 
is to move the current line to the first (or only) file you want the 
command to use, and then to issue EXECUTE (in the form "EXECUTE 
lines command") from the XEDIT command line. This method may be 
used on both display and typewriter terminals. 


For example: 

First move the current line (by using XEDIT subcommands' like UP or 
DOWN) to the first file you want to use in the command. Ona full 
screen display, the current line is the first file on the screen and 
is highlighted. Then (in the XEDIT command line) you type: 


execute n xedit 
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where "n" ais the number of files to be edited, starting with the 
current line. (You can use any command, not just XEDIT.) 


Notes; You can use XEDIT synonyms or macros to make issuing common 
commands easier. For example, you might want to set up a 
command "EX" to be a synonym for “EXECUTE 1 XEDIT". 


Using Symbols as Part of a Command 


Symbols can be used to represent operands in the command to be 
executed. They can be used in the commands typed on the screen, or 
aS part of the command in EXECUTE (on the command line). Symbols 
are needed if the command to ke executed has operands or options 
that follow the fileid. Examples of uSing symbols are in the 
"Examples" section, below. 


The following symbols can be used: 


4 means the filename filetype filemode displayed on the 
line. 

/a means the filename displayed on the line. 

/t means the filetype displayed on the line. 

/u means the filemode displayed on the line. 

/O means execute the line as iS, and omit appending anything. 


Any combinations of symbols can be used. For example: 


/n /t means: filename followed by filetype. 

/nt means: filename followed by filetype. 

/tD means: filetype followed by filename. 

/ntm is equivalent to / alone. 

/aunt means filename followed by filename and filetype 


Special Symbols Used Alone 


The following special symbols can be typed alone on the lines of the 
FILELIST display. They have the following meanings: 


= means execute the previous command for this file. 
Commands are executed starting at the top of the screen. 
For example, suppose you enter the DISCARD command ona 
line. You can then type an equal sign oon any other 
line (Ss). Those files preceded by equal Signs are 
discarded when the EXECUTE command is entered (from the 
command line or by pressing the PF10 key). 


2 means display the last command executed. The conmand is 
displayed on the line in which the ? is entered. 


means make this line the current line. (On the FILELIST 
screen, the current line is the first file on the screen.) 


\ 


rror Messages and Return Codes for EXECUTE 


ES SS 


CMSWEX561E CURSOR IS NCT ON A VALID DATA FIELD. RC=3 
CMSWEX526E OPTION ‘CURSOR! VALID IN DISPLAY MCDE ONLY. RC=3 
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DMSWEX654E INVALID SYMBOL ‘symbol'. {"yO* MUST BE SPECIFIED ALONE| 
INVALID CHARACTER ‘char FCLLOWING "/* SYMBOL}. RC=24 
DMSWEX651E "EXECUTE MUST FE ISSUED FROM FILELIST OR RDRLIST. RC=40 


On a typewriter terminal cnly: 
Executing: command 
+++E (nn) +++ 


DISCARD 


Use the DISCARD command to erase from disk a file that is displayed in 
the list. (DISCARD is eguivalent to the CMS command ERASE.) DISCARD 
can either be typed in the command area of the line that describes the 
file you want discarded, or it can be entered from the command line (at 
the bottom of the screen). 


The format of the DISCARD command as used in the FILELIST environment 
is: 


ee es ee a ey eg re et eg pt eae ee ee a ee ee ee ee te ee 
|DISCARD |[fn ft fn] | 
{eR erence eee) a a ee a gy DC EN | 


where: 


fn ft fm is the file identifier of the file to be erased. If DISCARD 
is typed on the line that describes the file to be discarded, 
no file identifier should be specified. The filenane, 
filetype, and filemode are appended automatically. 


Error Messages and Return Codes for LISCARD 
DMSWDC649E EXTRANEOUS PARAMETER 'parameter'. RC=24 


DMSWDC651E DISCARD MUST BE ISSUED FROM RDRLIST, PEEK OR FILELIST RC=40 
DMSWDC653E ERROR EXECUTING ‘command', RC = ‘nn'. RC=40 


Messages when in FILELIST and RDRLIST environments (in XEDIT): 


e 


DMSWDC652E MISSING OPERAND(S).- SPECIFY "EXECUTE [n] DISCARD*. RC=24 


Examples 
The following FILELIST screen was created by issuing the FILELIST 


command with no operands, which is equivalent to FILELIST * * A. Note 
that the files are sorted by date and time, newest to oldest. 
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a el a 
{| OHARA FILELIST A1 V 105 TRUNC=105 SIZE=418 LINE=1 COLUMN=1 [ 
| | 
| Cmd Filename Filetype Fm Format Lrecl Records Blocks Date Time | 
{ PIZZA TOPPINGS Al F 107 281 10 10/04/80 17:59:00] 
| COOKIE ASSEMBLE A1 F 98 49 2 10/03/80 15:17:01| 
| JELLY BEANS Al F 120 277 10 9/25/80 9:14:02] 
| DIETING TIPS Al F 75 28 1 9724780 12:10:03| 
| CUSTOMER LIST Al F 95 34 2 8704/80 21:12:04| 
| SEND EXEC Al F 80 101 G 8/04/80 15:33:05] 
| MY MEMO A1 V 26 7 1 8/01/80 16:50: 06| 
| MYMACRO XEDIT A1l V 95 29 2 7/30/80 20:58:07| 
| CMSFILES SCRIPT A1 V 80 489 30 7/26/80 16:05:08| 
| 1=Help 2=Refresh 3=Quit 7=Backward 8=Forward 9=FL/n | 
| 4=Sort(type) 5=Sort (date) 6=Sort(size) 10=Execute 11=XEDIT 12=Cursor | 
| === | 
XEDIT | 
( 
ree ee er ee ee 


Figure 10. Sample FILELIS1I Screen 


Examples of Using Symbols 


The following examples show how symbols can be used to represent 
operands in a command. The values substituted for the symbols and the 
resulting command are shown. In each case, the command can be entered 
in either of the following ways: 


e typed in the "Cmd" area of the screen. The command is executed 
either by entering EXECUTE on the XEDIT command line and then 
pressing ENTER, or by pressing PF10. 


© entered from the XEDIT command line, as an operand of EXECUTE (in 
the form "EXECUTE lines command"). 


If a symbol is not specified, the filename, filetype, and filemode are 
appended automatically to the command. 


a a a en pe oe ne ee ee 
| FILEID | COMMAND 1 RESULTING COMMAND [ 
Se re 
[pizza toppings a |discard {discard pizza toppings a ; 
|cookie assemble a jassemble /n jassemble cookie { 
[jelly beans a {copy / = flavors =|copy jelly beans a jelly flavors a| 
|dieting tips a [copy / /nt &£ |copy dieting tips a dieting tips b| 
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Use the FINIS command to close one or more files. The format of the 
FINIS command is: 


Dore eRe EB te me ig tie PUN mT GS gt fog eh te ET a ght fe wee Eee ieee aes Sg GE NET GPT a Bg Ty Jee 8 Met Oe ee, oe 71 

1 | ro4 \ 

| FINIS | £n £t |fn| | 

[ [. oe ae l 

| | = | 

Lee ew ww ow wn = a = on wn wn ew wm nt a wn wn wr wn wn wn wm on we ww ww = rn wn wn ww oo = ow oe ow oS J 

where: 

fn is the filename of the file to be closed. If you code an 
asterisk (*) in this field, all filenames are closed. 

ft is the filetype of the file to be closed. If you code an 
asterisk (*) in this field, all filetypes are closed. 

fn is the filemode of the file to be closed. If you code an 
asterisk (*) in this field, all disks are searched for the 
specified file. If this field is omitted, Al is assumed. 

Usage Note 


Use FINIS when your program does not close a file during its execution. 
CMS commands close files automatically at the end of their execution. 
(An 'EXEC' file is considered to be a single CNS command, independent of 
its content.) 

Responses 


None. 


If an error occurs, register 15 contains the following error code: 
Code Meaning 


6 File not open 
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Use the FORMAT command to: 

e Initialize a virtual disk (minidisk) for use with CMS files 
e Count or reset the number of cylinders on a virtual disk 

e Write a label on a virtual disk 


The format of the FORMAT command is: 


| | i 
| FORMAT | cuu mode [nocyl] [ (oftions...[) ]] | 
{ ; [ noblk ] [ 
l | l 
| | options: { 
| [ r r V4 ; 
| | [Blksize | 800] | | 
| | | [1024] | | 
| | | 12048] | | 
| l {4096 | | 
I | | { 1K] | | 
l l | [| 2K] | l 
I | ; 1 SKI | | 
| | | : 4 | l 
[ [ | Noerase [ { 
[ [ [Label [ | 
| | |Recomp | | 
{ | . _ l 


cuu is the virtual device address of the virtual disk to be 
formatted. 


Valid addresses are 001 through 5SFF for a virtual machine in 
basic control mode and 001 through FFF for a virtual machine 
in extended control mode. 


node is the filemode letter to be assigned to the specified device 
address. Valid filemcde letters are A through Z This field 
must be specified. If any other disk is accessed at mode, it 
is released. 


nocyl is the number of cylinders to be made available for use. All 
available cylinders on the disk are used if the number 
specified exceeds the actual number available. 


noblk is the number of FB-512 blocks to be made available for use. 
If the number specified exceeds the actual number of blocks on 
the disk, then all the blocks on the disk are made available 
for use. 


Options: 


BLKSIZE 
specifies the physical DASD block size of the CMS minidisk. 
The block sizes 1024, 2048, and 4096 may alternately be 
specified as 1K, 2K, and 4K, respectively. For FB-512 
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devices, only block sizes 1024, 2048, and 4096 are supported; 
for CKD (count key data) devices, all block sizes are 
supported. 


NOERASE 


specifies for FB-512 devices that the permanently formatted 
FB-512 blocks are not to be cleared to zeros. If not 
specified, the FB-512 blocks will be cleared. For non-FB-512 
devices, this opticn is ignored. 


LABEL writes a labél on the disk without formatting the disk. The 


CMS disk label is written on cylinder 0, track 0, record 3 of 
the virtual disk or block1 of an FB-512 device. A prompting 
message requests a six-character disk label (fewer than six 
characters are left-justified and blanks padded). 


RECOMP 


changes the number of cylinders or FB-512 blocks on the disk 
that are available to the user. This number becomes’ the 
actual number of minidisk cylinders or FB-512 blocks, or the 
number specified by nocylynoblk, whichever is less. If nocyl 
is not specified and the disk is formatted in 800-byte blocks, 
all cylinders are used. If the disk is formatted in 1K, 2K, 
or 4K blocks, the maximum number of cylinders initially 
formatted on the disk is made available to the uSer. 


Usage Notes 


You can use the FORMAT command with any virtual 3310, 3330, 3340, 
3350, 3370, 3375, 3380, or 2314 device. The speed matching buffer 
feature (Feature #6550) for the 3380 supports the use of extended 
count-key-data channel [frograms. 


When you do not specify either the RECOMP or LABEL option, the disk 
area is initialized by writing a device-dependent number of records 
(containing binary zeros) on each track. Any previous data on the 
disk is erased. A read after write check is made as’' the disk is 
formatted. For example: 


format 191 a 25 


initializes 25 cylinders of the disk located at virtual address 191 
in CMS format. The command: 


format 192 b 25 (reconmp) 
changes the number of cylinders available at virtual address 192 to 
25 cylinders, but does not erase any existing CMS files. To change 
only the label on a disk, you can enter: 

format 193 c (label) 
Respond to the frompting message with a six-character label. 
If you want to format a minidisk for VSAM files, you must use the 
IBCDASDI progran. If you want to format an entire disk, you may 
use any OS or DOS disk initialization frogran. 
Because the FORMAT ccmmand requires heavy processor utilization and 
is heavily I/O bound, system performance may be degraded if there 
are many users on the system when you use FORMAT. 


When formatting FB-512 devices, enough blocks of the minidisk area 
must be formatted to support the CMS disk structure, or message 
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DMS216E will be displayed, and the FORMAT request will be 
terminated. The number of FB-512 blocks which must be formatted 
for minidisks of 1K, 2K, and 4K CMS blocksize is 12, 24, and 48, 
respectively. 


6. If the FORMAT command with the RECOMP option fails and CMS issues 
message DMSFOR214W, “CANNOT RECOMPUTE WITHOUT LOSS OF DATA. NO 
CHANGE.", query your A-disk to determine the number of unallocated 
cylinders. If the number of cylinders seems adequate, it is 
possible that some of the allocated space is at the end of the 
disk, and is thus not available to the FORMAT command. Issue the 
command: 


COPY * * A = = = (REP 


followed by the FORMAT command with the RECOMP option. 


~J 
e 


Choosing an appropriate BLKSIZE to format a disk depends upon its 
intended use. A 4K BLKSIZE will optimize the I/0 if the disk is to 
contain large files with no missing records (dense). A BLKSIZE of 
1K is more appropriate when creating many small files or sparse 
files. For example, PL/I regional files are sparse and they may 
allocate more space on a 4K disk than on a 1K disk, therefore, the 
Smaller BLKSIZE is preferable. 


The larger the blocksize of the disk, the greater the amount of 
storage reguired for input/output buffers. Each buffer that the 
System needs must be a contiguous block of system keyed storage. 
The size of this area of storage being the blocksize of the disk. 
Programs that dynamically allocate storage based upon machine size 
May use up all of the available storage. This Bay not allow the 
systen enough storage to allocate buffers for its use. 
Consequently, a program needing a 4K disk that uses all of the 
available storage may be unable to get I/O buffers if they are not 
already allocated. For more information on CMS storage management, 
refer to the VWM/SP System Logic and Problem Determination Guide 
Vol. 2 - CMS. 


Responses 


DMSPOR603R FORMAT WILL ERASE ALL FILES ON DISK ‘mode(cuu)'. DO YOU WISH 
TO CONTINUE? (YES|NO): 


You have indicated that a disk area is to be initialized: all 
existing files are erased. This message gives you the option of 
canceling the execution of the FORMAT command. Reply yes or no. 
DMSFOR605R ENTER DISK LABEL: 
You have reguested that a label be written on the disk. Enter a 
one- to six-character label. 
DMSFOR705I DISK REMAINS UNCHANGED. 
The response to message DMSFOR603R was NO or a null line was 
entered. 
DMSFOR732I {'nnn' CYLINDERS|*nnnnnnnnnn!t FB-512 BLOCKS } FORMATTED ON 


DISK '*mode(cuu) ! 


The format operation is complete. 
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DMSFOR7331I FORMATTING DISK ‘mode’ 


The disk represented by mode letter ‘mode’ is being formatted. 


LABEL CUU M STAT CYL TYPE BLKSIZE FILES BLKS USED-(%) BLKS LEFT BLK TOTAL 


label cuu am 


This message provides the status of a 


R/W nnn type blksize nnann npnon- % nna nnopon 


disk when you use the RECOMP 


option. The response is the same as when you issue the QUERY 
command with the DISK operand. 

Qther Messages and Return Codes 
DMSFOROO3E INVALID OPTION ‘option RC=24 
DMSFOROOSE NO ‘option SPECIFIED RC=24 
DMSFORO17E INVALID DEVICE ADDRESS ‘cuut RC=24 
DMSFORO28E NO DEVICE SPECIFIED RC=24 
DMSFORO37E DISK ‘mode[ (cuu) ]' IS READ/ONLY RC=36 
DMSFORO4YSE INVALID MODE ‘mode RC=24 
DMSFORO69E DISK ‘mode* NOT ACCESSED kRC=36 
DMSFORO7VOE INVALID PARAMETER 'parameter' RC=24 
DMSFOR113S DEVICE ‘cuu!t NOT ATTACHED RC=100 
DMSFOR114S ‘cuu't IS AN UNSUPFORTED DEVICE TYPE 

OR REQUESTED BLKSIZE IS NOT SUPPORTED 

FOR THE DEVICE RC=88 
DMSFOR125S PERMANENT UNIT CHECK ON DISK ‘mode (cuu) * RC=100 
DMSFOR126S ERROR {READ|{ WRIT} ING LABEL ON DISK ‘mode(cuu)' RC=100 
DMSFOR214W CANNOT RECOMPUTE WITHOUT LOSS OF DATA. NO CHANGE RC=8 
DMSFOR216E INSUFFICIENT BLOCKS ON DISK TO SUPPORT 

CMS DISK STRUCTURE RkRC=100 
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Use the GENDIRT command to fill in a CMS auxiliary directory. The 
auxiliary directory contains the name and location of modules that would 
otherwise significantly increase the size of the resident directory, 
thus increasing search time and storage requirements. By using GENDIRT 
to fill in an auxiliary directory, the file entries for the given 
command are loaded only when the command is invoked. The format of the 
GENDIRT command is: 


ee 
| GENDIRT | directorynamne { targetnode } | 
Oar nn SS SP i SS US i eh --i anei -sn-P-PE- ie><enceersoupenensnnameenemnal 


where: 


directoryname 
is the entry point of the auxiliary directory. 


targetnode 

is the filemode letter of the disk containing the nodules 
referred to in the directory. The letter is the filemode of 
the disk containing the modules at execution time, not the 
filemode of the disk at creation of the directory. At 
directory creation time, all modules named in the directory 
being created must be on either the A-disk ora read-only 
extension; that is, not all disks are searched. The default 
value for targetmode is § (system disk). It is your 
responsibility to determine the usefulness of this operand at 
your installation, and to inform all users whose programs are 
in auxiliary directories exactly what filemode to specify on 
the ACCESS command. 


Note: For information on creating auxiliary directories and for further 
requirements for using the targetmode option, see the VM/SP System 
Programmer's Guide. 


Messages and Return Codes 
DMSGNDOO2W FILE 'fn ft fm*' NCT FOUND RC=4 
DMSGNDO21E ENTRY POINT ‘name* NCT FCUND RC=40 


DMSGNDO22E NO DIRECTORY NAME SPECIFIED RC=24 
DMSGNDO7OE INVALID PARAMETER ‘parameter®' kRC=24 
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Use the GENMOD command to generate a nonrelocatable (MODULE) file ona 
CMS disk. The format of the GENMOD command is: 


<x 
> 


Fh 
=] 


fm 


Gennod [fn [ MODULE [ fn | ]] [ (options...[) ]] 
| Al | 
L Jj 


options: [ FROM entry1 ] [ TO entry2 ] 
r 7V r 7V cr a | 
[MAP | iSTR | [OS | 
{NOMAP | {NOSTR | {DOS | 
L 4 L 4 [ALL 
[SYSTEM ] Lt 4 


ere: 
is the filename of the MODULE file being created. If fn is 
not specified, the file created has a filename egual to that 
of the first entry point in the LOAD MAP. 
is the filemode of the MCDULE file being created. If fm is 


not specified, Al is assumed. 


Options: If conflicting options are specified, the last one entered 
is used. 


FROM entry1 
specifies an entry point or a control section name that 
represents the starting virtual storage location from which 
the nonrelocatarle cory is generated. 


TO entry2 
specifies an entry point or a control section nane that 
represents the ending virtual storage location from which the 
honrelocatable copy is generated. 


MAP copies system loader table entries for the generated nodule 
into a load map record which is included at the end of the 
MODULE file. The record can contain aS Bany as 3276 load map 
entries. The MODMAP command can be issued to display the load 
map. 


NOMAP specifies that a load map is not to be contained in the MODULE 
file. 


Note: If a module is generated with the NOMAP option, that 
module cannot later be loaded and started with the CMS LOADMOD 
and START commands. When NOMAP is specified, the information 
produced is not sufficient for the START command to execute 
properly. However, a module generated with the NOMAP option 
can later be invoked as a command; that is, it can be invoked 
if its filename is entered. 
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STR invokes the CMS storage initialization routine when the MODULE 
file is subsequently loaded (see the LOADMOD command 
description). This routine frees any storage remaining from a 
previous program. STR is the default setting if the MODULE is 
to be loaded at the beginning of available user storage. 


If you have issued CMS SET RELPAGE ON, STR causes CMS storage 
initialization to release the remaining pages of storage. 


Note: If a program running in the user area calls a transient 
routine that was generated with the STR option, the user area 
Storage pointers will be reset. This reset condition could 
cause errors upon return to the original program (for example, 
when OS GETMAIN/FREEMAIN macros are issued in the user 
program). 


NOSTR indicates that, when the MODULE is loaded, free storage 
pointers are not reset for any storage currently in use. 
NOSTR is the default setting if the MODULE file is to be 
loaded at a location other than the default load address. 


SYSTEM indicates that when the MCDULE file is subseguently loaded, it 
is to have a storage frotect key of zero. 


OS indicates that the program may contain OS macros and, 
therefore, should be executed only when CMS/DOS is not active. 


DOS indicates that the program contains VSE macros; CMS/DOS must 
be active (that is, SET CCS ON must have been previously 
invoked) in order for thiS program to execute. (See Usage 
Note 2). 

ALL indicates that the progran: 


e Contains CMS macros and must be capable of running 
regardless of whether CMS/DOS is active or not 


e Contains no VSE or OS macros 

e Preserves and resets the DOS flag in the CMS nucleus 

e Does its own setting of the DOS flags 

Note: The ALL oftion is primarily for use by CMS” systen 
programmers. CaS system routines are aware of which 
environment is active and will preserve and reset the DOS flag 
in the CMS nucleus. 


Usage Notes 


1. The GENMOD command is usually invoked following the LOAD command, 
and possibly the INCLUDE command. For example, the sequence: 


load myprog 
genmod testprog 


loads the file MYPROG TEXT into virtual storage and creates a 
nonrelocatable load module named TESTPROG MODULE. TESTPROG may now 
be invoked as a user-written command from the CMS environment. 


2. The execution of MODULE files created from VSE programs is not 
Supported and may give unpredictable results. GENMOD is intended 
for use with the LCAD command, not the FETCH command. Storage 
initialization for FETCH is different from that for LOAD. 
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Before the file is written, undefined symbols are set to location 
zero and the common reference control section is initialized. The 
undefined symbols are not retained as unresolved symbols in the 
MODULE file. Therefore, once the MODULE file is generated, those 
references cannot be resolved and may cause unpredictable results 
during execution. 


If you load a program into the transient area you should issue the 
GENMOD command with the STR option. Be careful if the program uses 
OS GETMAIN or FREEMAIN macros because your program, plus the amount 
of storage obtained via GETMAIN, cannot exceed two pages (8192 
bytes). It is recommended that you do not use GETMAIN macros in 
programs that execute in the transient area. 


A transient module (loaded with the ORIGIN TRANS option) that was 
generated with the SYSTEM option is written on disk as a 
fixed-length record with a maximum length of 8192 bytes. 


If you are using FORTRAN under CMS, use FROM MAIN as an option to 
avoid unpredictable results. 


If FROM is not specified on the GENMOD command, the starting 
virtual storage location (entry foint) of the module is either the 
address of fn (if it is an external name) or the entry point 
determined according to the hierarchy discussed in Usage Note 4 of 
the LOAD command. This is not necessarily the lowest address 
loaded. If you have any external references before your START or 
CSECT instructions, you must specify the "FROM entry1' operand on 
the GENMOD command to load your frogram properly. 


If you are using PL/I under CMS, use FROM PLISTART as an oftion to 
avoid unpredictable results. 


Responses 


None. 


DMSMODOO3E INVALID OPTION ‘option RC=24 

DMSMODOO5E NO {FROM|TO} ENTRY SPECIFIED RC=24 
DMSHODO21E ENTRY POINT ‘name' NCT FOUND RC=40 
DMSMODO32E INVALID FILETYPE 'ft* RC=24 

DMSMODO37E DISK ‘mode* IS READ/ONLY RC=36 

DMSMODOYOE NO FILES LOADED RC=40 

DMSMODO7OE INVALID PARAMETER ‘parameter' RC=24 
DMSMODO84E INVALID USE OF 'FROM' AND "TO" CPTIONS RC=24 
DMSNHOD105S ERROR ‘'nn* WRITING FILE ‘fn ft fm" ON DISK RC=100 
DMSSTTO48E INVALID MODE *mode* RC=24 

DMSSTTO69E DISK ‘mode* NOT ACCESSED RC=36 


Section 2. CMS Commands’ 151 


GLOBAL 


GLOBAL 


Use the GLOBAL command to identify which CMS, CMS/DOS, or OS libraries 
are to be searched for macros, copy files, subroutines, VSE executable 
phases, or OS load modules when processing subsequent CMS commands. The 
format of the GLOBAL command is: 


| GLobal | MACLIB [libnamel ... libnane8] | 

| TXTLIB | 

| | DOSLIB 
| | LOADLIB { 

a a | 

where: 

MACLIB precedes the specification of mnacro libraries that are to be 
searched for macros and copy files during the execution of 
language processor commands. The macro libraries may be CMS 
files or OS data sets. If you specify an OS data set, a 
FILEDEF command must be issued for the data set before you 
issue the GLOBAL command. 

TXTLIB precedes the specification of text libraries to be searched 

for missing sukroutines when the LOAD or INCLUDE command is 
issued, or when a dynamic load occurs (that is, when an OS 
SVC 8 is issued). 
Note: Subroutines that are called by dynamic load should (1) 
contain only VCONsS that are resolved within the same text 
library member or (2) be resident in storage throughout the 
processing of the original CMS LOAD or INCLUDE command. 
Otherwise, the entry point is unpredictable. 

DOSLIB precedes the specification of DOS simulated core image 
libraries (that is, CMSyDCS phase libraries) to be searched 
for missing phases. This operand does not apply to systen 
Or private core image libraries residing on DOS disks. 
DOSLIB can be specified regardless of whether the CMS/DOS 
environment is active or not. 

LOADLIB precedes the specification of load module libraries to be 


searched for a module that the OSRUN command or the LINK, 
LOAD, ATTACH, Or XCTIL macros refer to. The libraries can be 
CMS LOADLIBS or OS module libraries. If you specify an OS 
data set, issue a FILEDEF command for the data set before 
you issue the GLCBAL command. 


litnamel... are the filenames of up to eight libraries. Filetypes must 
be MACLIB, TXILIB, DOSLIB, or lLOADLIB accordingly. The 
libraries are searched in the order in which they are named. 
If no likfrary names are specified, the command cancels the 
effect of any previous GLOBAL command. 


Usage Notes 
1. A GLOBAL command remains in effect for an entire CMS session unless 


it is explicitly canceled or reissued. If a program failure forces 
you to IPL CMS again, you must reissue the GLOBAL command. 
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There are no default liktraries; if you wish to use the same 
libraries during every terminal session, place the GLOBAL 
command(s) in your PRCFILE EXEC. 


If you want to use an OS library during the execution of a language 
processor, you can issue a GLOBAL command to access the library, as 
long as you have defined the library via the FILEDEF command. If 
you want to use that library for more than one job, however, you 
should use the PERM option on the FILEDEF command, since the 
language processors clear nonpermanent file definitions. 


To find out what libraries have been specified, issue the QUERY 
command with the MACLIB, TXTLIB, DOSLIB, LOADLIB, or LIBRARY 
operands. (The LIERARY operand reguests a display of all 
libraries.) 


For information on creating and/or manipulating CMS libraries, see 
the discussion of the MACLIB, TXTLIB, DOSLIB, and LOADLIB commands. 


Responses 


None. 


Messages and Return Codes 


DMSGLBOO2W FILE 'fn ft' NCI FOUND k&C=28 
DMSGLBO14E INVALID FUNCTION 'function' RC=24 
DMSGLBO4Y7E NO FUNCTION SPECIFIED RC=24 
DMSGLB108S MORE THAN 8 LIBRARIES SPECIFIED RC=88 
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The GLOBALV (GLOBAL Variakles) command addresses two primary needs: 1) 
the need for several EXECS to share a common set of values; 2) the need 
to retain those values, either temporarily or permanently, for 
subseguent use. 


Sharing 


Values are often given names, describing what they represent, for easy 
reference. Although the values often vary, their names usually do not. 
The GLOBALV command processor builds and maintains group(s) of named, 
variable values in free storage for shared use by EXECs. EXECs "share" 
a value by referring to it by a common name. When requested, GLOBALV 
retrieves a variable(s) from the group(s) and places it in the progran 
stack for subsequent use Ly the requesting EXEC. 


GLOBALV supports use of more than one group. This allows for grouping 
distinct variables that are either related or often used together, which 
facilitates both more efficient retrieval and more selective use. The 
"global variable group(s)", built ty GLOBALV from a set of CMS GLOBALV 
type files on the user's A—disk and extensions, exist throughout an IPL, 
unless explicitly purged or re—-initialized. 


When variables are defined or changed, the user decides whether the 
variables or changes are to last: 


1) For the current IPL only 
2) Throughout an entire session (normally, from LOGON to LOGOFF) 
3) Permanently, i.e. across sessions 


Variables defined for the current IPL only are retained in storage. 
Those required longer than a single IPL are retained in CMS files on the 
user's A—disk from where they are put in storage. The CMS filenames are 
SESSION GLOBALV (for values required throughout the session), and 
LASTING GLOBALV (for values that are to last permanently). These two 
files and a third A—disk file (INITIAL GLOBALV) are the’ source from 
which the GLOBALV command processor creates and initializes’ the 
variable(s) in storage. The INITIAL file is normally created by the 
user aS an alternative way of defining a large number of variables for 
an IPL. 


The CMS GLOBALV disk files may be of fixed or variable format. Fixed 
format facilitates creation cf files by users (via editing). It 
accommodates variables whose names and values do not exceed eight bytes 
each. The GLOBALV command processor useS variable format which allows 
for varying length variakle names and values. In addition, variable 
format includes a special field which, when used, identifies the group 
name into which the variable will be grouped. (See "Usage Note 1.") 


The GLOBALV command processor manages requests to define or set (SET...) 


variables both in storage and in the LASTING and SESSION GLOBALV files 
on the user's A—disk. 
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Note: 


GLOBALV 


t of the GLCBALV command is: 


Although this command may re used in CMS EXECS, it is designed for 


use with EXEC 2 EXECS. Restrictions/precautions are listed in 


a eee ee 
| | | 
| GLOBALV | INIT | 
| | r 1 | 
{ | SELECT |group | | 
| | | UNNAMED| | 
| | L J | 
| | cr 7 SET | 
| { | | SETS namel [value1] [name2 value2]... l 
| | | | SETP | 
| | | | | 
| | | | SETL i 
| [ |SELECT group {| SETLS | 
| | | UNNAMED | SETSL name [value] | 
I | | | SEILP | 
| | | | SETPL | 
| | | | 
| | ( | LIST [name1 [name2]... ] | 
l | | | J 
| | | | | 
| i | | STACK namel [nameé2]... | 
| | L J STACKR | 
I | | 
| SELECT group PURGE 
l | UNNAMED | 
| | | 
| | GRPLIST l 
| | GRPSTACK 
| [ PURGE " 
Se { 
| | 
I 
| | 


a cr soreeeecnarenseene naeanreem naaresenanses eee ni adrienne teas 


"Usage Notes for CMS EXECS". 


allocates and initializes global variable(s) in free storage 
from data in the LASTING, SESSION, and INITIAL GLOBALV files on 
the issuer's A-~disk and extensions. Not all files need be 
present. It also performs any needed cleanup (to eliminate 
multiple and null entries) in the LASTING GLOBALV file. 


If the records in the GLOBALV file(s) contain no group name, 
for grouping the variables, (as with fixed format records) 
GLOBALV's INIT function allocates only cne global variable 
group, UNNAMED, in free storage. Otherwise, (variable format) 
GLOBALV INIT will allocate as many unique global variable 
groups in free storage as identified in the GLOBALV files. 


GLOBALV INIT initializes free storage with variables defined in 
the LASTING, SESSION, and INITIAL GLOBALV files respectively. 
If any variables are defined more than once within the LASTING 
file or within the SESSION file, the value defined last in the 
file is the one used to initialize storage. If a variable of 
the same name is defined in both the LASTING and SESSION files, 
the value assigned in the SESSION file will override the value 
assigned in the LASTING file when the storage is initialized. 
(See "Usage Notes 2 and 3".) 


After initializing free—storage from the LASTING GLOBALV file, 
the file is re-written to eliminate multiple definitions for 
any variable names and any null (zero length) value 
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SELECT 


assignments. 


The global variable(s) in free storage are required by all 
other GLOBALV functions. Therefore, GLOBALV INIT is performed 
automatically if not explicitly requested prior to other 
GLOBALV requests. 


identifies the global variatle group which is the subject of 
this or subsequent SELECT subfunctions. If no subfunction is 
specified, the GLOBALV command processor interprets the conmand 
as a request to set the default group for subsequent SELECT 
subfunctions. The default is set to the group indicated by 
"group' or to UNNAMED if nc group is specified. A GLOBALV 
SELECT command that does specify a subfunction affects only the 
group specified in the command. It has no effect on setting or 
resetting the default group. 


The SELECT phrase (SELECT group or SELECT UNNAMED) is optional 
preceding all forms of the SELECT subfunctions, SET, LIST, and 
STACK. If the SELECT phrase is not used, the subfunction 
affects the default group, described above. (See "Examples" 
for uses of GLCEALV SELECT.) 


SELECT Subfunctions: 


SET 

SETS 

SETP assigns the value ‘valuel* to the variable 'nameti', the 
value ‘value2' to the variable ‘name2', etc. Since SET 
fields are delimited by blanks, the values cannot 
contain any blanks. (Use the SETL subfunction, 
described next, for such values.) If no value is 
specified, the value is assumed to be null. 


SET adds the assignment(s) in the selected or default 
global variable group in storage. If the variable nane 
is already defined, its value is replaced by the one 
specified in the command. SETS adds/replaces the 
asSsignment(s) in the selected or default group and 
appends it to the SESSION GLOBALV disk file. SETP 
adds/replaces the assignment(s) in the selected or 
default group and appends it to the LASTING GLOEALV disk 
file. 


CMS EXEC users, refer to "Usage Notes for CMS EXECs", 


SETL 

SETLS 

SETSL 

SETLP 

SETPL assigns the specified literal value, which may contain 
blanks, to the variable name. The first biank following 
the name delimits the name from the value field and is 
not part of the value. All characters following this 
blank (including any other blanks) are part of the 
value. If no value is specified, the value is assuned 
to be null. 


SETL adds the assignment in the selected or default 
global variable group in stcrage. If the variable nane 
is already defined, its value replaced by the one 
specified in the command. SETLS adds/replaces’ the 
assignment in the selected or default group and appends 
it to the SESSICN GLOBALV disk file. SETSL is 
equivalent to SETLS. SETLP adds/replaces the assignment 
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in the selected or default group and appends it to the 
LASTING GLOBALV disk file. SETPL is equivalent to 
SETLP. 


CMS EXEC users, refer to “Usage Notes for CMS EXECs". 


LIST displays a list of the specified variable name(s) and 
their associated value(s). If no name is specified, all 
variables in the selected or default group are listed. 


STACK places the value(s) associated with the specified 
variable name(s), from the selected or default group, 
LIFO in the program stack. When multiple variables are 
named in a single stack request, the values are stacked 
LIFO in the program stack such that’ the variable named 
first in the ccmmand is the first retrieved from the 
stack. Refer to Example 2 under "EXAMPLES". If a 
variable is not found in the group, a null (zero length) 
line is stacked. The command has no effect of the 
variable name is omitted. 


This stacking technigue reguires that the EXEC issue a 
separate "&READ ..." control statement to read each 
value from the stack. 


STACKR places a "&READL n* control statement and, for each 
Variable name specified, a "&name = &LITERAL OF value" 
asSignment statement LIFO in the program stack such that 
"SREAD n' is the first retrievable line. In the &READ 
control statement, ‘'n' is the number of subsequent 
asSignnent statements and, in the assignment statenent, 
'value' is the value associated with the specified 
variable name in the selected or default group. When 
multiple variables are named in a single STACKR reguest, 
the values are stacked LIFOQ in the program stack such 
that the "&READ n" is the first retrievable line fron 
the stack, and the first named variable assignment 
Statement is the next retrievable line from the stack, 
etc. Refer to Example 1 in the "Examples" section. The 
command has no effect if the variable name is omitted. 


This stacking technigue reguires only a Single 6&READ 
control statement to read all the variables named on the 
GLOBALV command from the stack. 

CMS EXEC users, refer to “Usage Notes for CMS EXECs". 


PURGE causes the variables in storage to _ be cleared. The 
group itself is not purged. 


Caution: If the SELECT phrase is not included with the 
PURGE subfunction the result will be a GLOBALV PURGE of 
all gloktal variable(s) in storage. 


displays a list of all* existing global variable groups. 


GRPSTACK places the names of all* existing variable groups, line by 


PURGE 


line, in the program stack such that these items will be the 
first retrievable from the stack. A null line, used as a 
delimiter, indicates the end of the stacked group names. 


causes all* global variable(s) in free storage to be released. 


*Note that “all" includes those groups created by use of the DEFAULTS 
and EXECUTE commands. 
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The CMS GLOBALV disk files may be of fixed or variable format. Fixed 
format records are 16 bytes in length and consist of two eight—byte 
fields that contain a variable name, followed by its assigned value. 
Variable format records may be up to 520 kbytes in length and consist 


et ee ee et: Pe eae eee ere merce al 

{| group name | f1 | variable nane | £2 | variable value | 

ee ee ee a a ee teeeenane eat: Ee cae 

0 8 9 n n+1 

of the following five fields: 

group nane — identifies the group for grouping the variable (fron 
GLOBALV [SELECT group| UNNAMED] SET...) 

£1 — defines the actual length of the variable name field 
immediately following 

variable name — identifies the name by which this shared value will 
be commonly referenced 

£2 — defines the actual length of the variable value 


field immediately following 
specifies the actual value assigned to the naned 
variable 


variable value 


Use fixed format when editing (creating or updating) files. Variable 
format records would be difficult to edit because changes in the 
variable name or variable value fields must also be reflected in 
their respective length fields. Although not impossible, this 
further editing is awkward and likely to be overlooked, increasing 
the chance of errors in those fields. 


To establish the initial set of lasting variables, the user may edit 
them into a fixed format LASTING file. Note that whenever the 
GLOBALV command processor rewrites this file, during initialization, 
it will use variable format. 


Probably the easiest way to create GLOBALV file(s) is to let the 
GLOBALV command processor do the work. Create an EXEC file 
containing the appropriate GLOBALV ... SETS and/or SETL commands. 
Then when the EXEC is invoked, the GLOBALV command processor will 
build the file(s) as it executes the commands. 


The SESSION file is not erased Ey the GLOBALV command processor. 
This is the responsibility of the user. The length of a session is 
thus determined by the frequency with which the user erases’ the 
SESSION GLOBALV file. To make the duration of a session the time 
between CMS IPLs, the user might choose to include an ERASE SESSION 
GLOBALV command in the PROFILE EXEC. To make a session last for all 
IPLs of CMS during one day, erase the SESSION GLOBALV file whenever 
the date changes. 


The SESSION GLOBALV file also is never cleaned up (to eliminate 
multiple and null entries) by the GLOBALV command processor, as the 
LASTING GLOBALY file is at each initialization. Without this 
automatic cleanup, the SESSION GLOBALV file continues to grow longer 
with each SETS and SETSL command. 


If the file is present during initialization of the global 
variable(s) in storage, its variables _ take precedence over LASTING 
variables of the same name. For variables of the same name defined 
within a file or in more than one file, the order of precedence, is: 
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SESSION — Last in file is used 
LASTING — last in file is used 
INITIAL — first in file is used 


So, for example, if a variable were defined for a given group several 
times in each file, and all files were present at initialization, the 
value used in the storage would be that defined last in the SESSION 
GLOBALV file. 


Usage Notes for CMS EXECs 

1. When defining values uSing GLOBALV's SELECT sukfunction, SET..., be 
aware that values (tokens) larger than eight characters will be 
truncated to eight characters by the CMS EXEC processor. 


2. Avoid use of GLOBALV's SELECT sutfunction, SETL... .~. It requires an 
extended parameter list, such as is provided by EXEC 2. Use in CMS 
EXECS causes an error from the GILOBALV command processor. 


3. Avoid use of GLOBALV's SELECT subfunction, STACKR. The literal 
assignnent statement it generates is not in a format the CMS EXEC 
processor recognizes. The CMS EXEC command processor will generate 
the following error message: 


DMSEXTO72E ERROR IN EXEC FILE fn, LINE nnn — INVALID ASSIGNMENT 


Examples 


These examples illustrate the use and effect of several, consecutive 
GLOBALV SELECT commands. 


Example 1. 


GLOBALV SET DEPT 222 


(SELECT phrase is onitted.) UNNAMED 


— Group _ 

Effect: The value '222" is assigned 
to variable name 'DEPT' in 
the default global variable 
group ‘UNNAMED'. 


DEPT 222 


GLOBALV SELECT TABA 


Effect: The default glckal variable 
group for subsequent SELECT 
subfunctions is set to 
'TABA'. 


TY Te 


GLOBALV SET EMP 8888 MCNTH MAY 


Effect: The value '8888' is assigned 
to the variable name ‘'EMP* 
and the value "MAY is as— 
Signed to the variable name 
"MONTH' in the default group 
"TABA*. 


EMP 8888 
MONTH MAY 
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GLOBALV SELECT UNNAMED SET YEAR 1982 


Effect: 


The value '1982' is assigned 
to the variable name 'YEAR'* 
in the global variable group 
"UNNAMED". The default set— 
ting is not changed. 


GLOBALV SETS YEAR 1981 


Effect: 


The value '1981" is assigned 
to the variakle name 'YEAR' 
in the default global vari- 
able group 'TABA*® and the 
assignment is entered into 
the SESSION GLCPALV disk 
file. 


GLOBALV STACK YEAR DEPT 


Effect: 


Places the value associated 
with variable name 'YEAR'* 
from group 'TABA* onto the 
stack. Since the variable 
"DEPT is not defined in 
global variable group ‘'TABA', 
a hull line is stacked. 


GLOBALV SELECT UNNAMED STACKR YEAR CEPT 


Effect: 


Places a "&S&READ 002" control 
statement, and two literal 
assignment statements, de- 
fining the variable name 
'YEAR' and the variable nane 
"DEPT" with their associated 
values from global variable 
group ‘UNNAMED*', onto the 
stack. 


UNNAMED 
Group _ 


DEPT 222 
YEAR 1982 


EMP 8888 
MONTH MAY 
YEAR 1981 


Next line 
to read: ABC 


Next 
line to 


read: &READ 002 
LITERAL OF 1982 
LITERAL OF 222 


&YEAR = 
& DEPT 
1981 


(null line) 


ABC 
XYZ 
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SESSION 
GLOBALV 
File 


YEAR 1981 


1981 
(null line) 
ABC 
XYZ 


ee TS 


Example 2. 


The effect of the following request, which 


GLOBALV SELECT TABA STACK EMP MCNTH YEAR 


Whereas, the effect of 3 consecutive STACK 
variable each (the same 23 variables as the 


GLOBALV SELECT TABA 
GLOBALV STACK EMP 
GLOBALV STACK MONTH 
GLOBALV STACK YEAR 


Responses 


GLOBALV 


names 3 variables: 


Next line 
to read: 


requests, naming a single 


Stack After 


Bultiple reguest above): 


Next line 
to read: 


Stack After 


1981 
MAY 
8888 


GLOBALV ... LIST results in a display of the requested list. 


GLOBALV GRPLIST results in a display of the reguested list. 


DMSGLOOY7E NO FUNCTICN SPECIFIED RC=24 


DMSGLO104S ERROR ‘nn* REALING FILE ‘fn ft fa 


DMSGLO618E NUCEXT FAILED RC=4nn 


FROM DISK RC=1Inn 


DMSGLO622E INSUFFICIENT FREE STORAGE — NO TABLE MADE RC=41 


DMSGLO628E INVALID GLOBALV FUNCTION "xxx! 


RC=4 


DMSGLO631E SETL/SETLP/SETLS CAN ONLY EE EXECUTED FROM AN EXEC 2 EXEC OR 


A CMS COMMAND RC=4 
DMSGLO649E EXTRANEOUS PARAMETER ‘paraneter' 


RC=24 
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Error Codes 


GLOBALV error codes consist of two 3-—character fields. The first field 
corresponds to errors encountered during the GLOBALV INIT function; the 
second corresponds to errors encountered during other GLOBALV functions. 


Code 


non|nnn 
000 ... 
004 


008 
012 
016 


024 
Inn 


Inn 000 


2M: “606 


000 
Inn 


3mnn .e. 


000 
008 


4nn 000 


Meaning 


Function completed successfully. 


Invalid function/subfunction; or invalid environment for 
use of function/subfunction. 

Error return from ATTN. Stacking suspended. 

No free storage available to define (SET..) additional 
variables. Processing suspended at point of error. 

A system error cccurred in preceding processing while 
GLOBALV was attempting to release its storage (presumably 
upon a NUCXDROP command). Reissue NUCXDROP. 

No functicn specified on GLOBALV command. 

I/O error appending newly defined variable(s) to LASTING 
or SESSION GLOBALV file on the user's A-—disk. The 
assignment was, however, added to the appropriate global 
variable group in storage. Refer to FSWRITE macro for 
meaning of ‘nn’. 


I/O error reading GLCBALV type files from user's A-—disk. 
No global variable(s) in storage created. Refer to 
FSREAD macro for meaning of ‘nn*. 


I/O error rewriting LASTING GLOBALV file into a temporary 
file. Glcbhal variatles in storage are created, but 
rewrite of the LASTING file was suspended. The original 
LASTING file remains intact on the user's A-—disk. Refer 
to FSWRITE macro for meaning of ‘nn'‘. 


Function completed successfully. 

I/O error appending newly defined variable(s) to LASTING 
or SESSION GLOBALV file on the user's A-—disk. The 
asSignment was, however, added to the appropriate global 
variable in storage. Refer to FSWRITE macro for meaning 
of 'nn'. 


Error occurred renaming the temporary LASTING GLOBALV file 
to become the new LASTING file. Global variables in 
storage are created. The original LASTING file was 
destroyed, but TEMPFILE GLOBALV contains its 
corresponding variatles. Refer to RENAME command for 
meaning of ‘nn*. 


Function completed successfully. 
Error return from ATTN. Stacking suspended. 


Error occurred when GILOBALV attempted to establish itself 
as a nucleus extension. GLOBALV initialization functions 
could not froceed. Refer to NUCEXT function for meaning 
of 'nn'*. 
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Issue the HELP command to use the CMS HELP facility. The HELP facility 
allows you to display a menu of the components for which HELP files are 
available, a menu of the HELP files available for a particular 
component, and the actual HELP files. HELP files contain descriptions, 
formats, and parameters of CMS and CP commands, EDIT, XEDIT, and DEBUG 
subcommands, and EXEC and EXEC 2 control statements, and descriptions of 
CMS and CP messages. The format of the HELP command is: 


Help Help 

message 

MENU 

component MENU 

F am 

|component| {name [ (oftion[) ] }} 
JCMS | 

L J 


EE eee 
fe ee ee ee i oe = Cl 


options: 


ALL 

FORM 
PARM 
DESC 


Seciiteammnanaamen 


_— eee ee eee eee eee eee eee ee ee 
ees eee se ae ee ee eee eee ee 
ape oe ee eee ee ee ee eee eee a ee ee 


HELP displays information on how to use the CMS HELP facility. 
HELP HELP displays a description of the function of the HELP 
Command, its syntax, keywords, operands, and options. 


message is the 7-character message id you specify to display the HELP 
file for a message. Specify the message id in the forn 
xxxnnnt, where: 


Xxx indicates the component (for example, DMS for CMS 
messages, DMK for CP messages) 


Dhh is the message number 
t is the message type 


Note that you must specify the 7-character message id, not the 
10-character id that also identifies the issuing module. For 
example, specify DMS250S rather than DMSHLP250S for 
information cn that message. 


MENU displays a list cf component menus available. The component 
menus list the commands, subcommands or EXEC control 
Statements for which HELP files are available. MENU is the 
default if no parameters are specified. 


component 


is the name of the component you want information about. The 
HELP facility has the following components: 
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component 


component 


option 


Examples: 


Component Description 


CMS , Conversational Monitor System commands 
CP Control Program commands 

DEBUG CMS DEBUG subcommands 

EDIT CMS EDIT subconmands 

EXEC CMS EXEC statements 

EXEC 2 EXEC 2 statements 

XEDIT XEDIT subcommands 

MENU 


displays the menu of HELP files available for the specified 
component. There is no default component when you’ specify 
component MENU. (For example, if you want to display the menu 
of CMS commands, you must issue HELP CMS MENU.) 


name 
displays the HELP file for the specified command, subcommand, 
or statement. CMS command abbreviations are the only 


abbreviations allowed when using HELP. If a component is not 
specified, CMS is assumed. Thus, if you want to display the 
HELP file for a CMS ccmmand, you need only specify: 


HELP name 
is valid only for CMS and CP commands and subcommands. You 


may specify DESC, FORM, PARM, or ALL. ALL is the default. 
The HELP ccmmand options are: 


ALL display the specified HELP file starting at the 


beginning. 


DESC display the specified HELP file starting with the 
description. 


FORM display the specified HELP file starting with the format 
specification. 


PARM display the specified HELP file starting with the 
parameter descriptions. 


When a HELP command oftion is specified, the entire HELP file 


is made available to the user. The options effect only the 
initial position of the HELP file display. 


These are examples of HELP requests issued as CMS commands. 


Remember that you may also request HELP files directly from menus or 
from the XEDIT environment. 


To request a HELP file for CP message DMKOO6I, issue: 


HELP 


DMKOO6I 


To request a menu of CP commands, issue; 


HELP 


CP MEND 


To request a HELP file for the XEDIT LOCATE subcommand, issue: 


HELP 


XEDIT LOCATE 


To request display of the HELP file for the CMS TAPE command beginning 
with the description, issue: 
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HELP CMS TAPE (DESC or HELF TAPE (DESC 


If you specify more than one oftion, only the first is checked for 
validity. 


HELP accesses the disk containing the system HELP files, if not 
already accessed (This disk is specified at system generation time 
by the system support personnel). The HELP disk is accessed using 
the first available filemode and remains accessed after HELP has 
completed processing. 


If the command or statement name begins with a special character, 
followed by alphanumeric characters (for example, EXEC statements 
&STACK and &END), HELP creates the filename by translating the 
special character as follows: 


is translated to QUESMARK 
is translated to EQUAL 
is translated to SLASH 
is translated to DBLQUOTE 
is translated to AMPRSANL 
is translated to ASTERISK 
- is translated to PERIOL 


*# OM sN. Il ov 


The first character of the name of the special character replaces 
the special character in the filename. 


Thus, the statements &STACK and &END would have the filenames 
ASTACK and AEND. Remember that these changes only apply to the 
filenames of the statements; they do not affect the way you call 
for a HELP file display. To display the HELP files for &STACK and 
SEND, you would issue HELP EXEC &STACK and HELP EXEC &END. 


Names which have mcre than one special character are handled 
differently. The first special character is handled as_ above. 
However, any special characters that are not the first character in 
the filename must be translated to the first character of their 
hame, even when asking for a HELP file display. (This applies to 
the special characters listed in the table above, andto the 
Asterisk, *, which must be translated to a. Remember that the 
asterisk is not valid as the first character of a filename.) 


Thus, to display the HELP files for the EXEC statements &*, &DISK*, 
and &DISK?, you would issue HELP EXEC &A, HELP EXEC S&DISKA, and 
HELP EXEC &DISKQ, respectively. The following table reviews all 
the above changes: 


| NAME | FILENAME | CALLED AS | 
| —___—___-____-____________— | 
| & {| AMPRSAND | & 
| SSTACK | ASTACK | S&STACK 
| &DISK? | ADISKQ | &DISKQ | 
| &* | AA 1 SA 
1 &$ | ag | 8% | 
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Messages and Return Codes 


DMSHLPOO3E 
DMSHLP1045 
DMSHLP109S 
DMSHLP143S 
DMSHLP250S 
DMSHLP251E 


Code 


807 
808 


DMSHLP252E 
DMSHLP254E 


DMSHELS29E 
DMSHELS45E 
DMSHEL561E 
DMSHELS86E 
DMSHEL640E 


DMSHLP9O7T 


INVALID OPTION ‘option RC=24 
ERROR ££ READING FILE ‘fn £t £fm* FROM DISK 
VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 


RC=104 


UNABLE TO LOAD SAVED SYSTEM OR LOAD MODULE [ ‘ERROR CODE=nn! ] 


I/O ERROR OR DEVICE ERROR RC=100 


HELP PROCESSING ERROR, CODE nnn ‘description* RC=12 
Description 

Output line too long. 

Format word parameter should be a number. 

Invalid format word. 

Format word parameter missing. 

Invalid format word parameter. 

Undent greater than indent. 

Excessive or negative space count generated. 

Numeric format word parameter 1s outside valid 
range. 

VALID OPTIONS ARE: DESC FORM PARM ALL RC=24 

HELP CANNOT FIND THE INFORMATION YOU REQUESTED. IF 
NOT MISSPELLED, PLEASE ENTER "HELP! FOR MENU SELECTION 


OR "HELP HELP" FOR THE HELP COMMANETZ RC=28 
"subcommand' SUBCOMMAND IS ONLY VALID IN EDITING MODE 
MISSING OPERAND (S) 

CURSOR IS NOT ON A VALID DATA FIELD 


NOT FOUND 

UNABLE TO ACCESS HELP DISK (cuu), RC='nn' FROM ACCESS 
COMMAND RC=100 

I/O ERROR ON FILE ‘fn ft fm* RC=256 
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Use the IDENTIFY command to display or stack the following information: 
your userid and node; the userid of the RSCS virtual machine; the date, 
time, time zone, and day of the week. 


The format of the IDEFNTIFY command is: 


[IDentify 


Options: 


{ (options...[) ]] 


options: 
cr 
| STACK [FIFO|LIFO] 
| FIFO 
| LIFO 
JIYPE 
L 


hee ees ee ee ee 


STACK [FIFO|LIFO] 


FIFO 


LIFO 


TYPE 


Responses 


specifies that the information should be placed in the progran 
stack rather than displayed at the terminal. The information 
is stacked either FIFO (first in first out) or LIFO (last in 
first out). The default crder is FIFO. 


specifies that the information should be placed in the progran 
Stack rather than displayed at the terminal. The information 
is stacked FIFO. The options STACK, STACK FIFO, and FIFO are 
all equivalent. 


specifies that the information should be placed in the progran 
stack rather than displayed at the terminal. The information 
is stacked LIFO. This option is equivalent to STACK LIFO. 


specifies that the information should be displayed at the 
terminal. This is the default option. 


The following information is displayed or stacked: 


rg a ee ee ee ee ae eae ee NS ee ee ee ee TT OS ee eee Re ee oe ee 
| userid AT node VIA rscsid date time zone day | 


is the userid of your virtual machine. 

is the RSCS node cf your computer. 

is the userid of the RSCS virtual machine. 
is the local date, in the form nu/dd/yy. 
is the local time, in the form hh:mm:ss. 
is the local time zone. 


is the day of the week. 
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Implementation notes: 
The userid and node are from the CP QUERY USERID command. The date, 
time, and zone are from the CP QUERY TIME command. 


The CP QUERY CPUID command is used to retrieve the CPU serial number. 
(CP QUERY cCPUID returns a 16-digit processor identification; however, 
IDENTIFY only uses digits three through eight.) This number is then 
looked up in the file SYSTEM NETID *. That file will have one or nore 
lines of the forn: 


Cpu-serial-number node rscsid 


If there is a conflict in nodes between the SYSTEM NETID file and CP 
QUERY USERID, the node in SYSTEM NETID takes precedence. If there is no 
record with a matching serial number, or if the file is not found, the 
rscsid is set to *. 


IDENTIFY keeps some of its information in storage, such as userid, node 
and rscsid. To change any of that information, you must issue NUCXDROP 
IDENTIFY and then reissue the IDENTIFY command. 


important Note 
The person responsible for the CMS system at an installation is 
responsible for creating the SYSTEM NETID file. This file should have a 
filemode of S2. 


Error Messages and Return Codes 

DMSIDEOO3E INVALID OPTION ‘'nn'* RC=24 

DMSIDEOS6E FILE ‘fn ft' CONTAINS INVALID RECORD FORMAT RC=32 
DMSIDEO70E INVALID PARAMETER "'nn' RC=24 

DMSIDE104S ERROR 'nnt READING FILE ‘fn £t fn' FROM DISK. RC=100 
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Use the INCLUDE command to read one or more TEXT files (containing 
relocatable object code) from disk and to load them into virtual 
Storage, establishing the proper linkages between the files. A LOAD 
command must have been previously issued for the INCLUDE command to 
produce desirable results. For information on the CMS loader and the 
handling of unresolved references, see the description of the LOAD 
command. The format of the INCLUDE command is: 


INclude fn... [ (options...[) ]] 


options: ff 


| | | 
| [ 1 OF 1 Ff 1 A 
| | {CLEAR | |RESET eee | ORIGIN arreee | 
| |NOCLEAR| | = il TRANS f| I 
[ | L J L J L J | 
; | r 1 r 1 r 4 r 1 r 4 ; 
| | |MAP | [TYPE | [INV | |REP | |AUTO | | 
| | | NOMAP| | NCTYPE| | NOINV| | NOREP| {| NOAUTO| | 
| | L J L J L J L | L J | 
| | r 7 r 1 i 
| | |ZIBE | [ START ] [ SAME ] [DUP | | 
| | | NOLIBE| | NODUP| | 
| | L J L J | 


ENS -é-< are the names of the files to be loaded into storage. Files 
must have a filetype of TEXT and consist of relocatable object 
code such as that froduced by the OS language processor. Ifa 
GLOBAL TXTLIB command has identified one or more TXTLIBs, fn 
May indicate the name of a IXTLIB member. 


Options: If options were specified with a previous LOAD or INCLUDE 
command, these options (with the exception of CLEAR and ORIGIN) 
remain set if SAME is specified when INCLUDE is issued. Otherwise, 
the options assume their default settings. If conflicting options 
are specified, the last one entered is in effect. 


CLEAR clears the load area in storage to binary zeros before the 
files are loaded. 


NOCLEAR 


SP a a Se 


does not clear the load area before loading. 


RESET a a 
4 

resets the execution starting point previously set by a LOAD 
or INCLUDE command. If entry is specified, the starting 
execution address is reset to the specified location. If an 
asterisk (*) is specified or if the RESET option is omitted, 
the loader input is searched for control statements. The 
entry point is selected fron the last ENTRY statement 
encountered or from an assembler- or compiler-produced END 
statement. If none is found, a default entry point is 
selected as follows: if an asterisk was specified, the first 
byte of the first control section loaded by the INCLUDE 
command becomes the default entry point; if the RESET option 
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was omitted, the entry fpoint defaults to the execution 
starting point previously set by a LOAD or INCLUDE command. 


ORIGIN rg 


NOLIBE 


START 


SAME 


NODUP 


TRANS 

begins loading the program at the location specified by 
hexloc; this location pust be in the CMS transient area or in 
the user area below the start of the CMS nucleus. The 
variable, hexloc, is a hexadecimal number of up to six 
Characters. If this option is not specified, loading begins 
at the next available storage location. INCLUDE does not 
overlay any previously loaded files unless this option is 
specified and the address given indicates a location within a 
previously loaded object module. TRANS indicates that’ the 
file is loaded into the transient area. 


adds information to the load nmap. 

does not add any information to the load map. 

displays the load map of the files at the terminal, as well as 
writing it on the A-disk. This option is valid only if MAP is 
specified or implied. 

does not display the load map at the terminal. 

writes invalid card images in the LOAD MAF file. 

does not write invalid card images in the LOAD MAP file. 
writes Replace (REP) statement images in the LOAD MAP file. 
See the explanation of the CMS LOAD command for a description 


of the Replace (REP) statement. 


Suppresses the writing of Replace (REP) statements in the LOAD 
MAP file. 


searches your disks for TEXT files to resolve undefined 
references. 


Suppresses automatic searching for TEXT files. 


searches the text libraries defined by the GLOBAL command for 
missing sukroutines. 


does not search any text libraries for unresolved references. 
begins execution after loading is completed. 


retains the same options (except ORIGIN and CLEAR) that were 
used by a previous INCLUDE or LOAD command. Otherwise, the 
default setting of unspecified oftions is assumed. If other 
options are specified with SAME, they override previously 
Specified options. (See Usage Note 1.) 


displays warning messages at your virtual console when a 
duplicate CSECT is encountered during processing. The 
duplicate CSECT is not loaded. 


does not display warning messages at your virtual console when 
duplicate CSECTS are encountered during processing. The 
duplicate CSECT is not loaded. 
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Usage Notes 


1. If you specify several nondefault options on the LOAD command and 
you want those options to remain in effect, use the SAME option 
when you issue the INCLUDE command; for example: 

include main subi data (reset main map Start) 
brings the files named MAIN TEXT, SUPI TEXT, and DATA TEXT into 
virtual storage and appends them to previously loaded files. 
Information about these loaded files is added to the LOAD MAP file. 
Execution begins at entry point MAIN. 

load myprog (nomar nolibe norep) 

include mysub (map same) 
During execution of the LOAD command, the file named MYPROG TEXT is 
brought into real storage. The following options are in effect: 
NOMAP, NOLIBE, NOREP, NOTYPE, INV, and AUTO. During execution of 
the INCLUDE command, the file named MYSUB TEXT 1s appended to 
MYPROG TEXT. The following cptions are in effect: 

MAP, NOLIBE, NOREF, NOTYPE, INV, AUTO 

2. When the INCLUDE command is issued, the loader tables are not 
reset. 

3. For additional information on the CMS loader, see the discussion of 
the LOAD command, or consult VM/SP CMS User's Guide. 

Responses 


DMSLIO740I EXECUTION BEGINS... 


START was specified with INCLUDE and the loaded program has begun 
execution. Any further responses are from the frogran. 


INVALID CARD — xxx...xXxx 


INV was specified with LOAD andan invalid card has’ been found. 
The message and the contents of the invalid card (xxx...xxx) are 
listed in the LOAD MAP file. The invalid card is ignored and 
loading continues. 


Other Messages and Return Codes 


DMSLGTOO2I FILE 'fn' TXTLIB NOT FOUND RC=0 

DMSLIOOO1E NO FILENAME SPECIFIED RC=24 

DMSLIOOO2ZE FILE ‘fn ft" NCT FOUND RC=28 

DMSLIOOO3SE INVALID OPTION toption® RC=24 

DMSLIOOOSE NO "option! SPECIFIED RC=248 

DMSLIOO21E ENTRY POINT ‘name' NCT FOUND RC=40 

DMSLIOO29E INVALID PARAMETER ‘parameter’ IN THE OPTION ‘option! FIELD 


RC=24 


DMSLIOO55SE NO ENTRY POINT DEFINED kRC=40 
DMSLIOO56E FILE "fn ft" CONTAINS INVALID [NAME] ALIAS] ENTRY| ESD] RECORD 


FORMATS RC=32 


DMSLIOOS9JE CMS/DOS ENVIRONMENT ACTIVE RC=40 

DMSLIO104S ERROR 'nn' READING FILE ‘fn ft fm FROM DISK RC=100 
DMSLIO105S ERROR 'nn* WRITING FILE ‘fn ft fm" ON DISK RC=100 
DMSLIO109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 


Section 2. CMS Commands’ 171 


INCLUDE 


DMSLIO116S LOADER TABLE QVERFLOW RC=104 

DMSLIO168S PSEUDO REGISTER TABLE OVERFLCW RC=104 

DMSLIO169S ESDID TABLE CVERFLOW RC=104 

DMSLIO201W THE FOLLOWING NAMES ARE UNDEFINED: RC=4 

DMSLIO202W DUPLICATE IDENTIFIER ‘identifier’ RC=4 

DMSLIO203W "SET LOCATION COUNTER" NAME ‘name UNDEFINED RC=4 

DMSLIO2ZQO6W PSEUDO REGISTER ALIGNMENT ERROR RC=4 

DMSLI0623S MODULE CANNOT BE LOADED AT LOCATION ‘location’ BECAUSE 
WOULD OVERLAY THE CMS NUCLEUS RC=88 

DMSLIO90O7T I/O ERROR ON FILE 'fn £t fm" RC=256 


172 IBM VM/SP CMS Command and Macro Reference 


LABELDEF 


LABELDEF 


Use the LABELDEF command to specify standard HDR1 and EOF1 tape label 
description information for CMS, CMS/DOS, and OS simulation. This 
command is required for CMS/DOS and CMS tape label processing. It is 
optional for OS simulation. However, it is needed if you want to 
specify a filename to be checked or the exact data to be written in any 
field of an output HDR1 and EOF1 label. The format of the LABELDEF 
command is: 


ny ew a OT Oe eae pe eg Rane ag ee gg ane, ae ag a eigen eg eg ee, ee 


LAbel def | 


| r 1 | 
[ [ ‘| | CLEAR | i 
| | (fn r 1 1 | 
| | | — ? i [VOLID volid] [VOLSE¢ volseq] i | 
| i | | fid)| | | 
l | | - a | od 
| | | i i 
| i | [FSEQ fseqg] [GENN genn]}] [GENV genv] i sl 
| i | r 7 i | 
( | | [CRDTE yyddd] [EXDTE yyddd] |SEC({0)]| | | 
| 1 | | Tel isi 
| I | | 3) | | | 
l I i " - i | 
| | | [ (options...[) ]] | | 
| i | | | 
| | & 4+ 
| | Options: 
| | r 7 | 
| | [PERM] |ICHANGE | 
| | | NOCHANGE| l 
| | v - l 
ni te a a ee | 
where: 

* may be specified only with CLEAR. It clears all existing 


label definitions. 

filename is one of the following: 
ddname for FILEDEF files (CS simulation). 
filename in DTFMT macro (CMS/DOS simulation). 


labeldefid specified in the TAPEMAC or TAPPDS command or in 
the LABID field of the TAPESL macro (can be 1-8 characters). 


CLEAR removes a label definition. 


LABELDEF filename CLEAR clears only the label definition for 
that filename. 


LABELDEF * CLEAR removes all existing label definitions 
unless specified as PERM. 


FID{ ? 
{fia} Supplies the file (data set for OS) identifier in the tape 
label. Use the FID ? form if the identifier exceeds 8 
Characters (up to a maximum of 17) or the identifier contains 
special characters. The system responds by prompting you to 
supply the information. If the file identifier does not 
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VOLID volid 


exceed 8 characters, enter the fileid directly (FID fid). 


is the volume serial number (1-6 numeric characters). 


VOLSEQ volseg 


FSEQ fseqg 


GENN genn 


GENV genv 


CRDTE yyddd 


EXDTE yyddd 


SEC 


Options 
PERM 


CHANGE 


NOCHANGE 


is the volume sequence numker (1-4 numeric characters). 


is the file (data set for OS) seguence number in the label 
(1-4 numeric characters). 


is the generation number (1-4 numeric characters). 


is the generation version (1-2 numeric characters). 


is the creation date. 


is the expiration date. 


specifies security classification (0 , 1, or 3). See the IBM 
publication OS/VS Tape Labels, GC26-3795, for the meaning of 
security classification on tape files. Note that this number 
has no effect cn how the file is processed. It is used only 
for checking or writing furposes. 


retains the current definition until it either is explicitly 
Cleared or is changed by a new LABELDEF command with the 
CHANGE option. If PERM is not specified, the definition is 
Cleared when a LABELCEF * CLEAR command is executed. 


merges the label definitions whenever a label definition 
already exists for a filename and a new LABELDEF command 
specifying the same filename is issued. In this situation, 
the options associated with the two definitions are nerged. 
Options from the original definition remain in effect unless 
duplicated in the new definition. New options are added to 
the option list. 


retains the current label definition, if one exists, for the 
specified filename. 


The following default values are used in output labels when a value is 
not explicitly specified: 


174 


FID 


VOLID 
FSEQ 
VOLSEQ 


GENN 


For OS sigulation, fid is the ddname specified in the 
FILEDEF command for the file. 


For CMS/DOS, fid is the DTIFMT symrolic name. 


For the CMS TAPESL macro, fid is the LABEFLDEF specified in 
the LABID parameter. 


is CMS0O01. 
is 0001. 
is 0001. 


is blanks. 
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GENV is blanks. 
CRDTE is the date when the lakel is written. 
EXDTE is the date when the latel is written. 


SEC is 0. 


Usage Notes: 


1. 


To check a field in an input label, specify it on your LABELDEF 
command for the label. If you do not specify a value for a 
particular field, this field is not checked at all for input. For 
output, any field you specify is written in the label exactly as 
you specify it on the LABELDEF command. If you do not specify a 
field for output, the default value for that field is written in 
the label. 


If you write the following LABELDEF command, 
labeldef filex fid master fsegq 2 exdte 78285 


and use the statement for an input file, only the file identifier, 
file sequence number, and expiration date in HDR1 labels are 
checked. Error messages are issued when there fields in the tape 
label do not match those specified in the LAEELDEF statement. If 
you use the same statement for an output file, the fields leave the 
following values: 


fileid MASTER 

file sequence numrer 0002 

volume sequence number 0001 

creation date date when label is written 
expiration date 78285 

security 0 

volume serial number CmMS001 

generation number brlank 

generation version blank 


If you issue LABELDEF without any operands, a list of all LABELDEFs 
currently in effect is displayed on your terminal. 


For OS simulation, a LABELDEF statement may be used as well asa 
FILEDEF statement for a file. Use of a LABELDEF statement is 
optional in this case. The statements 


filedef filez tap1 sl volid vol4 
labeldef filez fid payroll fsegq 2 exdte 78300 


define filez as a labeled tape file on tape 181. The volume serial 

is VOL4, the fileid is PAYROLL, and the file seguence number is 

0002. Expiration date is day 300 in 1978. If you only use the 

FILEDEF command, you have only defined the VOLID (volume serial 

number). 

For CMS and CMS/DOS, a LABELDEF command is reguired. The command 
labeldef filel4 volid supvol volseg 3 

defines a tape label with a volume serial of SUPVOL and a volume 

seguence number of 0003. This LABELDEF statement could be used by 

a CMS/DOS program containing a DIFMT macro with the form 


FILE14 DIFNT e «eFILAEL=STD... 
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or by a CMS program with a TAPESL macro similar to the following: 


TAPESL HOUT, 181,LABID=FILE14 


A CMS TAPEMAC command could use the same LABELDEF as follows: 


tapemac maclib sl filetl4 


In all three preceding examples, the LABELDEF statement 


issued before the program or ccmmand is executed. 


must be 


5- See the section "Tape Labels in CMS" in the VWM/SP CMS User's Guide 


for more details on CMS tape lakel processing. 


Other Messages and Return Codes 


DMSLBDOO3E INVALID OPTION-option RC=24 

DMSLBDO29E INVALID PARAMETER ‘parameter' IN THE OPTION 
RC=24 

DMSLBDO65E "option OPTION SPECIFIED TWICE RC=24 


DMSLBDO66E ‘option AND toption' ARE CONFLICTING OPTIONS RC=24 


DMSLBDO7OE INVALID PARAMETER ‘parameter’ RC=24 
DMSLBD221E INVALID DATA SET NAME RC=24 

DMSLBD324I NO USER DEFINED LABELDEFS IN EFFECT RC=20 
DMSLBD7O4I INVALID CLEAR REQUEST RC=24 
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Use the LISTDS command to list, at your terminal, information about the 
data sets or files residing on accessed OS or DOS disks. In addition, 
use LISTDS to display extent or free space information when you want to 
allocate space for VSAM files. The fcrmat of the LISTDS command is: 


a aaa aa iam eae: 
| lor 1 l 
1 |? | ea [ (options...[) ]] options: l 
| LISTDS | |dsname| l(* : = | 
{ } & 4 | EXTENT | | 
{ | [FREE | [ 
| | . : l 
| | [ FORMAT ] | 
| | [ PDS J l 
ee ac ll ep ep lt ec mnt i pe eee 
where: 

4 indicates that you want to enter interactively the OS data 


set name, VSE fileid, cr VSAM data space name. When you 
enter a question mark (?), CMS prompts you to enter the OS 
data set name, DOS fileid, or VSAM data space name exactly as 
it appears on the disk. This form allows you to enter names 
that contain embedded kElanks or hyphens. 


dsnane is the OS data set name or VSE fileid or VSAM data space 
Name. It takes the form: 


gqual1 [qual2 qualn] 
quali [.qual2 qualn)}) 


where gquall, gual2, through gqgualn are the qualifiers of the 
dataset. If Elanks separate the qualifiers, the dataset nane 
used will be the concatenation of the qualifiers with 
periods. (See Usage Note 1.) 


fn is the filemode of the disk to ke searched for the specified 
file. If a dsname is not specified, a list of all the files 
or data sets on the specified disk is displayed. 


* indicates that you want all of your accessed DOS or OS disks 
searched for the specified data set or file. If a dsnane is 
not specified, a list of all files on all accessed OS and DOS 
disks is displayed. 


Options: The FREE and EXTENT options are mutually exclusive; the 
FORMAT and PDS options cannot be specified with either FREE or 
EXTENT. 


FREE requests a display cf all free space extents on a specific 
Minidisk cr on all accessed DOS and OS disks. If ycu enter 
the FREE option, you cannot specify a dsnane. 


EXTENT requests a display of allocated extents for a single file 

EX or for an entire disk or minidisk. If a dsname is specified, 
only the extents for that particular file or data set are 
listed; if fm is specified as *, all disks are searched for 
extents occupied by that file. 
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FO 
FO 


If a dsname is not specified, then a list of all currently 
allocated extents on the specified disk, or on all disks, is 
displayed. 


RMAT requests a display of the date, disk label, filemode, and 
data set name fcr an OS data set as well aS RECFM, LRECL, 
BLKSIZE, and DSORG infcrmation. For a VSE file, LISTDS 
displays the date, disk label, filemode, and fileid, but 
gives no information about the RECFM, LRECL, and BLKSIZE (two 
blanks appear for each); DSORG is always PS. 


PDS displays the member names of referenced OS partitioned data 


sets. 


For examples of the displays produced as a result of each of these 
options, see the "Resfcnses" section, below. 


Usage Notes 


1. 
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If you want to enter an OS or VSE file identification on the LISTDS 
command line, it may consist of qualifiers separated by periods or 
blanks. For example, the file TEST.INPUT.SOURCE.D could be listed 
as follows: 


listds test input source d 
listds test.input.source.d 


Or, you can enter the name interactively, as follows: 

listds ? * 

DMSLDS220R ENTER DATA SET NAME: 

test.input.source.d 
Note that when the data set name is entered interactively, it must 
be entered in its exact form; when entered on the LISTDS command 
line, the periods may Le omitted. 


You must use the interactive form to enter a VSE fileid that 
contains embedded blanks. 


When using access method services, use the FREE option to determine 
what free space is available for allocation by VSAM. For example: 


listds * (free 
requests a display of unallocated extents on all accessed OS or DOS 
disks. You can then use the EXTENT option on the DLEL command when 
you define the file for AMSERV. 


Full disk displays using the FREE cption will display free 
alternate tracks as well as free space extents. 


Since CMS does not sufport ISAM files, LISTDS lists extent and free 
information on ISAM files, but ignores format 2 DSCB's. 


Since CMS does not support track overflow, LISTDS will not read 
beyond a track if [CCB=RECFM=T is specified for the OS VTOC. 
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Responses 
DMSLDS220R ENTER DATA SET NAME: 


This message prompts you to enter the data set name when you use 
the ? operand on the LISTDS command. Enter the file identification 
in its exact form. A Sample sequence might be: 


listds ? c 

DMSLDS220R ENTER DATA SET NAME: 
ny.-file.test 

FM DATA SET NAME 

C MY.FILE.TEST 

R; 


The response shown above following the entry of the data set name 
is the same as the response given when you enter a data set name on 
the LISTDS command line. 


DMSLDS229I NO MEMBERS FCUND 


This message is displayed when you use the PDS option and the data 
set has no members. 


DMSLDS233I NO FREE SPACE AVAILABLE ON ‘'fm'" DISK 


This message is displayed when you use the FREE option and there is 
no free space availakle on the srecified disk. 


Responses to the EXTENT Option: A sample response to the EXTENT option 
is shown below. The headers and the type of information supplied are the 
same when you reguest information for a specific file only, or for all 
disks. 


listds g (extent 


EXTENT INFORMATION FOR "VTCC* ON 'G*" DISK: 
SEQ TYPE CYL-HD(RELIRK) TO CYL-HD (RELTRK) TRACKS 
000 vToc 099 00 1881 099 18 1899 19 


EXTENT INFORMATION FOR "PRIVAT.CCRE.IMAGE.LIB* ON 'G*" DISK: 
SEQ TYPE CYL-HD(RELTRK) TO CYL—-HD(RELTRK) TRACKS 
000 DATA 000 01 1 O89 18 949 949 


EXTENT INFORMATION FOR "SYSTEM.WORK.FILE.NO.6' ON 'G* DISK: 
SEQ TYPE CYL-HD(RELTRK) TO CYL-HD(RELTRK) TRACKS 
000 DATA 050 Q0 950 051 18 987 38 


EXTENT INFORMATION FOR ‘COFOL TEST PROGRAM! ON 'G* DISK: 
SEQ TYPE CYL-HD(RELTIRK) TO CY¥L-HD(RELTRK) TRACKS 
000 DATA 052 02 990 054 01 1027 38 


EXTENT INFORMATION FOR "DKSQO1At ON 'G* DISK: 

SEQ TYPE CYL-HD(RELTRK) TO CYL-HD(RELIRK) TRACKS 
000 DATA 080 01 1521 081 00 1539 19 
or for a fixed-block device: 

EXTENT INFORMATION FOR "DSQO1A* ON G DISK: 


SEQ TYPE REL-FIK TO REL-BLK BLOCKS 
000 DATA 00500 00550 51 
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SEQ indicates the sequence numker assigned this extent when the 
extents were defined via the DLBL command. CMS assigns the 
sequence numbers for VSAM data sets; the first extent set has a 
sequence of 000, the second extent has a sequence of 001, and so 
on. 


TYPE can have the following designations: 


Type Meaning 

DATA Data area extent 

VTOC VTOC extent of the disk 

SPLIT Split cylinder extent 

LABEL User lakel extent 

INDEX ISAM index area extent 

OVFLO ISAM independent overflow area extent 

MODEL Model data set label in the VTOC. Does not define an extent 


CYL-HD(RELTRK) TO CYL-HD (RELTRK) 
indicates the cylinder, head, and relative track numbers of the 
start and end tracks cf this extent. 


TRACKS indicates the number of tracks in the extent. 


REL-BLK TO REL-BLK 
indicates the relative block numbers of the start and end of the 
extent. 


BLOCKS indicates the number of Elocks in the extent. 


Response to the FREE Option: A sample response to the FREE option is 
shown below. The same headers and type of information is shown when you 
request free information for all accessed disks. 


listds g (free 
FREESPACE EXTENTS FOR 'G* DISK: 
CYL-HD(RELTRK) TO CYL-HD(RELTRK) TRACKS 


052 00 988 052 01 989 2 
054 02 1028 080 00 1520 493 
081 01 1540 098 18 1880 341 


or for a fixed-block device: 


listds g (free 
FREESPACE EXTENTS FOR 'G* DISK: 
REL-BLK TO REL-ELK BLOCKS 


501 1330 830 
10310 29610 19301 
68990 69990 1001 


where: 
CYL-HD(RELTRK) TO CYL-HD(RELTRK) 
indicates the cylinder, head and relative track numbers of the 
starting and ending track in the free extent. 
TRACKS indicates the total number of free tracks in the extent. 
REL-BLK TO REL-BLK 
indicates the relative block number of the start andend of 
extents that are free on the fixed-block device. 


BLOCKS indicates the total number of blocks contained in each extent. 
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Response to the FORMAT and PDS Options: If you enter the FORMAT and PDS 
options, you receive information similar to the following: 


listds d (fo pds) 


RECFM LRECL BLKSI DSORG DATE LABEL FM DATA SET NAME 
FB 80 800 PO 01/31/75 OSSYS1 D SY¥S1.MACLIB 
MEMBER NAMES: 
ABEND ATTACH BLDL BSP CLOSE DCB DETACH DEVTYPE 
FIND PUT READ WRITE XDAP 
RECFM LRECL BLKSI DSORG DATE LABEL FM DATA SET NAME 
F 80 80 PS 01/10/75 OSSYS1 OD SAMELE 


Other Messages and Return Codes 


DMSLDSOO2E DATA SET NOT FOUND RC=28 

DMSLDSOO3E INVALID CPTICN ‘option' RC=24 

DMSLDSOYS8E INVALID MODE 'modet RC=24 

DMSLDSO69E DISK 'mode* NOT ACCESSED RC=36 

DMSLDS117E INVALID EXTENT FOUND FOR ‘data set name ON 'fm' DISK RC=24 

DMSLDS221E INVALID DATA SET NAME RC=24 

DMSLDS222E I/O ERROR READING ‘data set name FROM {fmj{OS{DOS} DISK 
RC=28 

DMSLDS223E NO FILEMODE SPECIFIEL RC=24 

DMSLDS226E NO DATA SET NAME ALLOWED WITH FREE OPTION RC=24 

DMSLDS227W INVALID EXTENT FOUND FOR ‘datasetname' ON {fm|[OS| DOS} DISK 
RC=4 

DMSLDS231E I/O ERROR READING VTOC FROM {fm{OS|DOS} DISK RC=28 
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Use the LI 
residing o 


STFILE command to obtain specified information about CMS files 
hn accessed disks. The format of the LISTFILE command is: 


Listfile 


I r r r 1114 | 
| jfn |ft |fm [1 ({ (options...[)] ] l 
li * | * §€ * Ft I | 
| L L L J 4d J | 
| d 
| options: l 
| { 
l or 1 of 1 =f 1 | 
[ | Header | | Exec[ Trace ][ ARGS ]| | FName | [Blocks] | 
| | NOHeader | | Trace [ARGS] i | Ffype | | 
; oe 3 | APpend {ARGS] | 4 FMode | [ &x j | 
| | SIACK [FIFO|LIFO]| | FOrmat | | 
; | FIFO i j ALloc | { 
| | LIFO i | Date | i 
| Q JI | Label | | 
| - = | 
[ | 


fn 


Output 
HEADER 


is the filename of the files for which information is to be 
collected. If an asterisk is coded in this field, all 
filenames are used. 


In addition, certain special characters (* and %) can be used 
as part of the filename to request that the list contain a 
specific subset of files. See the usage note, "Pattern 
Matching", for information on using these special characters. 


is the filetype of the files for which information is to be 
collected. If an asterisk is coded in this field, all 
filetypes are used. 


In addition, certain special characters (* and %) can be used 
as part of the filetype to request that the list contain a 
specific subset of files. See the usage note, "Pattern 
Matching", for information on using these special characters. 


is the filemode of the files for which information is to be 
collected. If this field is omitted, only the A-disk is 
searched. If an asterisk is coded, all accessed disks are 
searched. 


Format Options: 


includes column headings in the listing. HEADER is the 
default if any of the supplemental information options 
(FORMAT, ALLOCATE, DATE, or LABEL) are specified. The 
format of the heading is: 


FILENAME FILETYPE FM FORMAT LRECL RECS BLOCKS DATE TIME LABEL 


NOHEADER does not include column headings in the list. NOHEADER is 
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the default if only filename, filetype, or filemnode 
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information is requested. 


Output Disposition Options: 


EXEC creates a CMS FXEC file of 80- or 88-cCharacter records (one 
record for each of the files that satisfies the given file 
identifier) on your A-disk. An 80-character record file is 
created unless you specify the LABEL option, in which case 
an 88-character record file is created. If a CMS EXEC 
already exists, it is replaced. The header is not included 
in the file. 


TRACE causes the EXFC 2 statement &TRACE OFF to be written as the 
first record of the CMS EXEC file, which is created when 
the EXEC option is specified. With this option, no 
statements issued from the CMS EXEC file are traced. For 
more information on the &TRACE statement, see the VM/SP 
EXEC 2 Reference. The TRACE option implies the EXEC 
option. 


ARGS causes EXEC 2 dummy arguments &3 through &15 to be appended 
to each line in the CMS EXEC file (following the fileid of 
each file). Each record of the CMS EXEC file has the form: 


61 &2 fileid &3 &4 &5 G66 ...&15 


Specifying this option allows you to pass up to 15 
arguments to the CMS EXEC file. The ARGS option does not 
imply the EXFC option and therefore must be specified in 
conjunction with EXEC, TRACE, or APPEND. 


APPEND creates a CMS EXEC and appends it to the existing CMS EXEC 
file. If no CMS EXEC file exists, one is created. 


STACK [ FIFO|LIFO ] 
specifies that the information should be placed in the 
program stack (for use by an EXEC or other program) instead 
of being displayed at the terminal. The information is 
stacked either FIFO (first in first out) or LIFO (last in 
first out). The default order is FIFO. 


FIFO specifies that the information should be placed in the 
program stack rather than displayed at the terminal. The 
information is stacked FIFO. The options STACK, STACK 
FIFO, and FIFC are all equivalent. 


LIFO specifies that the informaticn should be placed in the 
program stack rather than displayed at the terminal. The 
information is stacked LIFO. This option. .is equivalent to 
STACK LIFO. 


Information Reguest Options: 


information Request Cptions: Only one of these options need be 
specified. If one is specified, any options with a higher priority 
are also in effect. If none of the following options are specified, 
the default information request options are in effect. 
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FN 


FT 


FM 


AME creates a list containing only filenames. Option priority 
is 7. 

YPE creates a list containing only filenames and filetypes. 
Option priority is 6. 

ODE creates a list containing filenames, filetypes, and 
filemodes. Ofticn priority is 5. 

pplemental Information Options: 


FORMAT includes the record format and logical record length of 


each file in the list. Cption priority is 4. 


ALLOC includes the amount of disk space that CMS has allocated to 


the specified file in the list. The quantities given are 
the number of blocks and the number of logical records in 
the file. Opticn priority is 3. 


DATE includes the date the file was last written in the list. 
The form cf the date is: 
month/day/year hour:minute 
for 800-byte block disks, or: 
month/day/year hour:minute:second 
for all other format sizes. 
Option priority is 2. 

LABEL includes the label of the disk on which the file resides in 
the list. Option friority is 1. 

Other Options: 

BLOCKS Causes the total numker of CMS’ blocks used by the files in 
the list to re displayed as the last line of the list, in 
the form BLOCKS n. It is displayed as a Separate line. 

aX is used to change the place holding character from % to x, 


where x is any character, for this invocation of LISTFILE. 
For more information on using a place holding character, 
see the usage note, "Pattern Matching", below. 


Usage Notes 


1. 
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Pattern Matching 


If you enter the LISTFILE command with no operands, a list of all 
files on your A-disk is displayed at the terminal. 


If you want information about a specific subset of your files, you 
can use two special characters in the fn and ft operands. (Only an 
asterisk may be specified for filemode.) The special characters 
are * (asterisk) and % (percent), where: 


* represents any number of character(s). AS many asterisks as 


required can apreéar anywhere in a filename or filetype. (Only 
one asterisk may be used for a filemode.) 
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For example, if you enter: 

listfile *d* *file* 

you are requesting that the list contain all files on your 
A-disk whose filename ccntains "d" and whose filetype contains 
"file". The list might contain the following files: 

YOURDATA AFILE1 Al 


HISDATA AFILE2 Al 
ADOG 1DOGFILE A2 


% is a place holding character that means a_ single character, 
but any character will do. AS many percent symbols as 
necessary may appear anywhere in a filename or filetype. For 
example, if you enter: 


filelist RAR stock 

you are requesting that the list contain all files on your 
A-disk whose filename is three characters in length and whose 
filetype is "stock". The list might contain the following 
files: 

THE STOCK Atl 

HIS STOCK Atl 

HER STOCK Al 


The default place holding character (%) can be changed by 
using the &x cption. For example, 


listfile $ script (%$ 


displays all SCRIPT files on the A-disk whose filename is one 
character in length. 


If you request any additional information with the supplemental 
information options, that infcrmation is displayed along with the 
header. 


When you use the EXEC or APPEND option, the CMS EXEC Al that is 
created is in the format: 


&1 6&2 filename filetype filemode 
where column 1 is blank. 


If you specify the ARGS option with EXEC or APPEND, each line in 
the CMS EXEC is in the format: 


&1 &2 filename filetype filemode &3 &4& &5 &6 ...&15 


This allows you to pass up to 15 arguments to the EXEC. For 
example, if the following command is issued, 


LISTFILE * * A (EXEC ARGS 


a CMS EXEC file is created, with each record formatted as shown 
above. The following command 


CMS TAPE DUMP ( WIM 
causes the tape dumping command to be executed against each file in 


the CMS EXEC, with TAPE assigned to &1, DUMP to &2, ( to &3, and 
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WIM to &4,. 


If you use any of the supplemental information options, that 
information is included in the EXEC file. For information on using 
CMS EXEC files, see the VWM/SP CMS User's Guide. 


You can invoke the LISTFILE command from the terminal, from an EXEC 
file, or as a function from a program. If LISTFILE is invoked as a 
function or from an EXEC file that has the &CONTRCL NOMSG option in 
effect, the DMSLSTOO2ZE FILE NOT FOUND error message is not issued. 


To display only the files with a particular filemode nunber, 
specify the numeric fortion of the filemode in the listfile 
command. For example, to display oniy the files with filetype 
"EXEC* on your A2 disk: 


Listfile * exec a2 
The display might look like this: 


ALPHA EXEC A2 
SEND EXEC A2 
TEMP EXEC A2 


The options STACK, LIFO, and FIFO cause the requested information 
to be placed in the program stack. When the requested information 
is to be stacked, the options relating to the CMS EXEC (APPEND, 
EXEC, TRACE, and ARGS) andthe options relating to the display 
format (HEADER, NOHEADER) should not be specified. 


Responses 


Unless the EXEC, TRACE, APPEND, STACK, LIFO, or FIFO oftion is 
specified, the requested information is displayed at the terminal. 
Depending on the options specified, as discussed above, the information 
displayed is: 


FILENAME FILETYPE FM FORMAT LRECL RECS BLOCKS DATE TIME LABEL 


fn 
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F 
ASSEMBLE fm i lrecl norecs noblks mn/dd/yy hh:mm:ss volid 


where; 

fn is the filename of the file. 

ft is the filetype of the file. 

fm is the filemode of the file 

{i} is the file format: F is fixed-length, V is variable- 

V length. 

lrecl is the logical record length of the largest record in the 
file. 

norecs is the number of logical records in the file. 

noblks is cata mea of physical blocks that the file occupies 
on disk. 
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mn/dd/yy 


hh:emm: 


volid 


ss 


LiISTFILE 
is the date (month/day/year) that the file was last 
updated. 


1s the time (hours:minutes:seconds) that the file was 
last updated. 


is the volume serial number of the virtual disk on which 
the file resides. 


One entry is displayed for each file listed. 


Other Messages and Return Codes 


DMSLSTOO2E 
DMSLSTOO3E 
DMSLSTO37E 
DMSLSTO4UBE 
DMSLSTO66E 
DMSLSTO69E 
DMSLSTO7OE 
DMSLST105S 


PILE 
INVA 
DISK 
INVA 
"opt 
DISK 


NOT FOUND RC=28 

LID OPTION ‘option RC=24 
'mode' IS READ/ONLY RC=36 

LID MCDE ‘mode* RC=24 

ion' and ‘option ARE CONFLICTING OPTIONS RC=24 
"‘mode* NOT ACCESSED RC=36 


INVALID PARAMETER ‘parameter' RC=24 


ERRO 


R 'nn* WRITING FILE ‘fn ft £m*' ON DISK RC=100 
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Use the LISTIO command in CMS/DOS to display a list of current 
asSignments for system and/or programmer logical units in your virtual 
machine. The format of the LISTIO command is: 


L J 


| ( SYS | 
| LISTIO | \ PROG [ (options...[) ]] | 
| | )SYSxxx options: i 
| \a r 1 | 
| i JUA {EXEC | [STAT } { 
| | {ALL | APPEND| | 
( | [ 


where: 

SYS requests a list of the physical devices assigned to all systen 
logical units. 

PROG requests a list of the physical devices assigned to programmer 
logical units SYS000 through SY¥S241. 

SYSxxx requests a display of the physical device assigned to the 
particular logical unit specified. 

A requests a list of only those logical units that have been 
assigned to physical devices. 

UA requests a list af only those logical units that have not been 
assigned to physical devices; that is, that are unassigned. 

ALL requests a list of the physical units assigned to all systen 


and programmer logical units. If no operand is specified, ALL 
is the default. 


Options: The EXEC and APPEND options are mutually exclusive; if both 
are entered on the command line, the last one entered is in effect. 


EXEC erases the existing $LISTIO EXEC file, if one exists, and 
creates a hew one. 


APPEND adds new entries to the end of an existing $LISTIO EXEC file. 
If no $LISTIO EXEC file exists, a new one is created. 


STAT lists the status (read-only or read/write) of all disk devices 
currently assigned. 


Usage Notes 


1. Logical units are assigned and unassigned with the ASSGN command. 
For alist of logical units and valid device types, see_ the 
discussion of the ASSGN command. 
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2. The $LISTIO EXEC contains one record for each logical unit listed. 
The format is: 


&1 6&2 SYSxxx ones 
mode [status ] 


where column 1 is Elank. 


Responses 


Depending on the operands specified, the following is displayed for each 
unit requested in the LISTIO command: 


SPoxEx Gey ice 
mode [status] 


where device is the device type (READER, PRINTER, PUNCH, TERMINAL, TAPn, 
IGN, or UA). If the device is a disk, the one-character mode letter is 
displayed. If the STAT option is specified, the status (R/O or R/W) is 
also displayed. 


Other Messages and Return Codes 


DMSLLUOO3E INVALID OPTION ‘option RC=24 

DMSLLUOOGE NO READ/WRITE ‘A* DISK ACCESSED RC=36 

DMSLLUO7VOE INVALID PARAMETER ‘parameter' kC=24 

DMSLLUOSSE CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 

DMSLLU105S ERROR 'nn* WRITING FILE "$LISTIO EXEC A1*" ON DISK RC=100 
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Use the LKED command to create a CMS LOADLIB or LOADLIB member. The 
format of the LKED command is: 


fnane { (options...[) ]] 


Options: 
[ NCAL ][ LET ][ ALIGN2 ][ NE][{ OL ][ RENT] 


[ REUS ][ REFR ][ OVLY ][ XCAL ] 


f [ 
l [ 
[ i 
i | 
( ( 
| i 
| [ 
| [NAME membername ]|[/LIBE librarynane ] : 
lr 5 ee 1 °F 1 | 
| |XREF| |TERM | [PRINT | | 
[| IMAP | {NOTERM| |DISK | l 
| [LIST] ¢& 4 | NOPRINT| 
| L J L J | 
l rc "7 ; 
| |SIZE (valuel value2 | | 
i | valuel [ | 
| t | valuel, i [ 
l | ,Value2 | | 
l i | ’ [ l 
( |: = a { 


where: 
fnane specifies the filename of the object file to be processed. 
The file must have a filetype of TEXT and fixed-length, 
80-character records. 
Options: 


If duplicate or conflicting linkage editor options are specified, the 
linkage editor resolves them according to normal procedures (refer to 
OS/VS Linkage Editor and Loader) If duplicate or conflicting 
CMS-related options are specified, the last one entered on the 
command line is in effect. The CMS-related options are: TERM, 
NOTERM, PRINT, DISK, NOPRINT, NAME, and LIBE. 


NCAL suppresses the automatic library cali function of the linkage 
editor. 


LET Suppresses marking of the load nodule "not executable" in the 
event of some linkage editor error condition. 


ALIGN2 
indicates that boundary alignment specified in the linkage 
editor input file is to be performed on the basis of 204%8-byte 
boundaries. If this option is omitted, alignment is perforned 
on the basis of 4096-byte boundaries. 


NE marks the load module output as "not to be edited" such that 
it cannot be processed again by the linkage editor. 


OL marks the load module output "only loadable". 


RENT marks the load module reenterable. 


190 IBM VM/SP CMS Command and Macro Reference 


LKED 


REUS marks the load module reusable. 

REFR marks the load module refreshable. 

OVLY processes an overlay structure. 

XCAL allows valid exclusive CALLIs in the overlay structure. 


NAME membernane 
is the member name to be used for the load module created. 
The member name specified here overrides the default name, but 
it cannot override a name specified via the linkage editor 
NAME control statement. 


LIBE librarynane 
is the filename of a LOADLIB file where the output load module 
is to be placed. The LOADLIB file specified here may also be 
used for auxiliary input to the linkage editor via the INCLUDE 
statement. 


XREF produces an external symbol cross-reference for the modules 
being processed. 


MAP produces only a module map for the processed module(s). 


LIST includes only linkage editor control messages in the printed 
output file. 


TERM displays any linkage editor diagnostic messages at the user 
terminal. 


Suppresses the displaying of diagnostic messages. 
PRINT spools the linkage editor printed output file to the printer. 


DISK stores the linkage editor output ina CMS disk file witha 
filetype of LKEDIT. 


NOPRINT 
produces no output file. 


SIZE valuel value2 
indicates the amount of virtual storage to be used by the 
linkage editor and specifies the portion of that storage to be 
reserved for the load module buffer. The SIZE parameters nust 
lie within the following limits: 


valuel 64K to 9999K (or 65536 to 999999) 
value2 6K to 100K (or 6144 to 102400) 


If either of the SIZE parameters is omitted or is invalid, the 
default values established for the parameters are substituted. 
Values greater that 999999 can be entered in the form nnnonk 
(with K equal to 1024). For example, enter 2000K instead of 
2048000. Values accepted by the linkage editor are displayed 
in the output file. 


Usage Notes: 


1. 


Only a subset of the possible linkage editor control statements are 
meaningful in CMS. Since the CMS interface program cannot examine 
the input data for the LKED command, all of the control statements 
are allowed, even though several of them result in the creation of 
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92 


a load module file that cannot be used under CMS. For both command 
options and control statements, see the publication OS/VS Linkage 


Editor and Loader. 


When you use the linkage editor INCLUDE control statement to 
include a load module, the DDNAME referring to the module library 
Must be other than SYSLMOD and it must have been previously defined 
by a FILEDEF. If you include a member of the load 1ib which 
receives linkage editor output, you can enter statements in the 
following form: 


filedef libdef disk mylib loadlib A 
lked fname (lib mylib) 

include libdef (libmem1) 

hane libmen2 


The LKED command produces one temporary file: 
fname SYSUT!1 


This file is temporarily created for each link-edit step; any 
existing file with the same file identifier is erased at the 
beginning of the link edit. This file is placed on the read/write 
disk with the most available space. Work space is automatically 
allocated as needed during the link edit and returned to available 
status when the link edit is complete. Insufficient space causes 
abnormal termination of the link edit. 


The LKED command produces two permanent file: 


fname LOADLIB 
fname LKEDIT 


The ‘fname LOADLIB' file contains the load module(s) that’ the 
linkage editor created. This file is in CMS simulated partitioned 
data set format, as created by the CMS OS data management macros. 
The filename of the input file becomes the filename of the LOADLIB 
file, unless the LIBE option is specified. The filename of the 
input file also becomes the member name of the output load module, 
unless either the NAME option or a NAME control statement is used. 
One or more load modules may be created during a single LKED 
command execution if the NAME linkage editor control statement is 
used in the input file. When the NAME control statement is used, 
that name becomes the member name in the LOADLIB file. The replace 
option of the NAME statement determines whether existing members 
with the same name are replaced or retained. 


The ‘fname LKEDIT' file contains the printed output listing 
produced according to the XREF, MAP, or LIST options. This file is 
created on disk unless the PRINT or NOPRINT option is specified. 
The LOADLIB and LKEDIT files are placed on (1) the disk from which 
the input file was read, (2) the parent disk, or (3) the primary 
disk. Failure to obtain sufficient space for these files results 
in abnormal termination of the linkage editor. 
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Use the LOAD command to read one or more CMS or OS TEXT files 
(containing relocatable object code) from disk and to load them into 
virtual storage, establishing the proper linkages between the files. 
The format of the LOAD command is: 


ooo ee te Pe pe ee eG Oe ne a ee eB Se ee Pee bees A 


| LOAD | EN. 2c [ (options...[) ]] | 
| [ r 1 cr 1 r 1 4 
| i options: |CLEAR | [RESET fertry) | {ORIGIN Perris | | 
l l | NOCLEAR| | * i l TRANS § | 
| i L J t J L J | 
4 [ r 1 r c 1 cr 7 rc 1 ; 
i [ |MAP | [TYPE | [INV | [REP | {AUTO | | 
" ( | NOMAP| | NOTYPE | {| NOINV| | NOREP| | NOAUTO| | 
j [ u J L J L J L J L J | 
I | r 1 c 1 l 
| [LIBE | [START] {DUP | | 
| ( | NOLIBE] | NODUP| | 
| | u J L J i 


EN 6x5 specifies the names of the files to be loaded into storage. 
The files must have a filetype of TEXT and consist of 
relocatable object code such as that produced by the OS 
language processors. If a GLOBAL TIXTLIB command has been 
issued, fn may indicate the name of a TXTLIB member. 


Options: If conflicting options are specified, the last one entered 
is in effect. Options may be overridden or added when you’ use the 
INCLUDE command to load additional TEXT files. 


CLEAR clears the load area in storage before the object files are 
loaded. Whole page frames are released; the remainder of 
storage that is not on a page boundary is set to binary 
zeros. 


NOCLEAR does not clear the load area before loading. 


RESET ee 
* 

sets the starting location for the programs currently loaded. 
The operand, entry, must be an external name (for example, 
CSECT or ENTRY) in the loaded programs. If RESET is not 
specified, the default entry point is used. (See Usage Note 
4.) If * is entered the results are the same as if the RESET 
option were onitted. 


Note: The RESET option should not be used when loading TEXT 
files created by any of the following OS/VS language 
processors under CMS: OS Code and Go FORTRAN, OS FORTRAN IV 
(G1), OS FORTRAN IV (H) Extended, OS/VS COBOL Compiler and 
Library, OS Full American National Standard COBOL Version 4 
Compiler and Likrary. 
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ORIGIN re 

TRANS . 

loads the program beginning at the location specified by 
hexloc; this location must be in the CMS transient area or in 
the user area below the start of the CMS nucleus. The 
location, hexloc, is a hexadecimal number of up to six 
characters. If TRANS is specified, the file is loaded into 
the CMS nucleus transient area. If ORIGIN is not specified, 
loading begins at the first available storage location in the 
user program area. 


Note: Any program loaded into the transient area must have a 
Starting address of X*"EQOO'. See the discussion of the 
GENMOD command for information on loading programs in the 
transient area. 

MAP writes a load bap on your A-disk, named LOAD MAP A5. 

NOMAP does not create the LOAD MAP file. 

TYPE displays the load map at your terminal, as well as writing it 
on the A-disk. This option is valid only if the MAP option 
is in effect. 

NOTYPE does not display the load map at the terminal. 


INV includes invalid card images in the load map. 


NOINV does not include invalid card images in the load map. 


REP includes Replace (REP) statements in the load map. 

NOREP does not include the Replace (REP) statements in the load 
map. 

AUTO searches your virtual disks for TEXT files to resolve 


undefined references. 
NOAUTO suppresses automatic searching for TEXT files. 


LIBE searches the text libraries for missing subroutines. If text 
libraries are to be searched for TEXT files, they must 
previously have been defined by a GLOBAL command. 


NOLIBE does not search the text libraries for unresolved references. 


START executes the program being loaded when loading is completed. 
LOAD does not normally begin execution of the loaded files. 
To begin execution immediately upon successful completion of 
loading, specify START. Execution begins at the default 
entry point. (See Usage Note 4.) 


Oo 
Cc 
ty 


displays warning messages at your terminal when a duplicate 
CSECT is encountered during processing. The duplicate CSECT 
is not loaded. (See Usage Note 3.) 


NODUP does not display warning messages at your terminal when 
duplicate CSECTs are encountered during processing. The 
duplicate CSECT is not loaded. 


Usage Notes 
1. You must have a read/write CMS A-disk accessed when you issue the 


LOAD command; the loader creates a temporary workfile named DMSLDR 
SYSUT1 and writes it on the A-disk. 
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Unless the NOMAP option is specified, a load map is created on the 
A-disk each time the LOAD command is issued. A load map is a file 
that contains the location of control sections and entry points of 
files loaded into storage. This load map 1s named LOAD MAP AD5. 
Each time LOAD is issued, a new LOAD MAP file replaces any previous 
LOAD MAP file. 


If invalid card images exist in the file or files that are being 
loaded, they are listed with the message INVALID CARD in the LOAD 
MAP file. To suppress this listing in the load map, use the NOINV 
option. 


If Replace (REP) statements exist in the file being loaded, they 
are included in the LCAD MAP file. To suppress this listing of REP 
statements, specify the NOREP option. 


If the ENTRY or LIBRARY control cards are encountered in the 
file, the load maf contains an entry: 


CONTROL CARD- ... 
listing the card that was read. 


Mapping of any common areas that exist in the loaded files will 
occur when the program is prepared for execution by the START or 
GENMOD command or by the START option of the LOAD or INCLUDE 
comnmand. An updated load map may be displayed prior to progran 
execution if the START command is issued with the NO option to 
suppress execution. 


Duplicate CSECTs (control sections) are bypassed by the loader. 
Only the first CSECT encountered is physically loaded. The 
duplicates are not loaded. A warning message is displayed at your 
terminal if you specified the DUP option. If a section contains an 
ADCON that references a duplicate CSECT that has not been loaded, 
that ADCON may be resolved incorrectly. 


The loader selects the entry point for the loaded program according 
to the following hierarchy: 


e From the parameter list on the START command 

e From the last RESET operand in a LOAD or INCLUDE command 

e From the last ENTRY statement in the input 

e From the last LDT statement in the input 

e From the first assembler- or compiler-produced END statement 
that specifies an entry point if, no ENTRY statement is in the 
input 

e From the first byte of the first control section of the loaded 
program if there is no ENTRY statement and no assembler- or 
compiler-produced END statement specifying an entry point 

The LOAD command should not be’ used to execute programs containing 

DOS macros. To link-edit and execute programs in the CMS/DOS 

environment, use the DOSLKED and FETCH commands. 

See Figure 11 for an illustration of the loader search order. The 

loader uses this Search order to locate the filename on the LOAD 


and INCLUDE command lines, as well as in the handling of unresolved 
references. 
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| Use standard order of search to | 
| locate the TEXT files specified | 
| l 
L J 


by f£n ... 
| 
| 
e *, 
- * Any *., ——_— 
- * unresolved * . NO | Search | 
* . references - * i complete l 
x ? . * eerste Sart oe | 
xo . * 
* 
| YES 
[ 
~ *, 
.- * Is * . 
oo NCAUTO * . YES 
xs specified . *——_______, 
x ? . * | 
x . * 
* l 
{NO l 
I | 
1 | 
| Use standard order of search to | | 
| locate files with a filetype of | | 
| TEXT and a filename correspond— | | 
| ing to the unresolved reference {| | 
a eet ee ee aa | 
I< 4 
| 
oF x 
- * Any * . —---1 
- * unresolved * . NO i Search | 
* . references - *————_| complete | 
* ? . * earner 
x . * 
x 
[YES 
| 
- *. 
- * &Is ar eco > 471 
- * NOLIBE * . YES | Search | 
* specified - *———-| complete | 
x ? . * eee ee eee 
x . * 
x 
{NO 


Search active text libraries 
(those that were previously 
specified by a GLOBAL ccamand) . 
Files are searched in the order | 
they are entered in the command. | 
ee 
{ 

{ 


fst 
| Search complete 
ee 


Figure 11. Loader Search Order 
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7. The CMS loader also loads routines called dynamically by OS LINK, 
LOAD, and XCTL macros. Under certain circumstances, an incorrect 
entry point may be returned to the calling program. See the VM/SP 
CMS User's Guide for more details. 


8. LOAD does not clear user storage unless the CLEAR option is 
specified. 


LOADER CONTROL STATEMENTS 


You can add loader control statements to TEXT files either by editing 
them or by punching real cards and adding them to a punched text deck 
before reading it into your virtual machine. The seven control cards 
recognized by the CMS loader are discussed helow. 


The ENTRY and LIBRARY cards, which are discussed first, are Similar 
to the OS linkage editor control statements ENTRY and LIBRARY. The CMS 
ENTRY and LIBRARY statements must be entered beginning in column 1. 


ENTRY Statement: The ENTRY statement specifies the first instruction to 
be executed. It can be placed before, between, or after object modules 
or Other control statements. The fcrmat of the ENTRY statement is shown 
in Figure 12. The external name is the name of a control section or an 
entry name in the input deck. It must be the name of an instruction, 
not of data. 


a 
| ENTRY | external name ] 
ea a eR ee ae EN me a ee ae eee Te eee 


Figure 12. ENTRY Statement Format 


LIBRARY Statement: The LIBRARY statement can be used to specify the 
never—call function. The never—call function (indicated by an asterisk 
(*) as the first operand) specifies those external references that are 
not to be resolved by the automatic library call during any loader step. 
It is negated when a deck containing the external name referred to is 
included as part of the input to the loader. The format of the LIBRARY 
Statement iS shown in Figure 13. The external reference refers to an 
external reference that may be unresolved after input processing. It is 
not to be resolved. Multiple external references within the parentheses 
must be separated Ly commas. The LIBRARY statement can be placed 
before, between, or after object decks or other control statements. 


re ge a ee ee ee ee eg a ee ea ee ee et ae ae a ee 
| LIBRARY | * (external reference) | 
ee a ee Le ee ee ee ee ee ee 


Figure 13. LIBRARY Statement Format 


Loader Terminate (iDT) Statement: The LDT statement is used in a text 
library as the last record of a member. It indicates to the loader that 
all records for that member were processed. The LDTIT statement can 
contain a name to be used as the entry point for the loaded member. The 
LDT statement has the format shown in Figure 14. 
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Cg ee a ee Pee eS ee ee fe ae Net ee ET ee a ee ee ee ee 
Column | Contents 


X*Q2" (12—2—9 punch). 
Identifies this as a loader control statement. 


| l 
| | 
{ y | 
[ [ \ 
| i l 
| 24 | LDT — identifies type of statement. | 
; | ; 
{| 5-16 | Not used. | 
| t i 
{| 17-24 | Blank or entry name (left—justified and padded with | 
i | blanks to eight characters). i 
l [ d 
| 25 | Blank. | 
[ | [ 
{ 26-33 | May contain information specified on a SETSSI card | 
| | processed by the TXTLIB command. i 
l i [ 
| 34-80 | Not used. | 


Figure 14. LDT Statement Format 


Include Control Section (ICS) Statement: The ICS statement changes the 
length of a specified control section or defines a new control section. 
It should be used only when REP statements cause a control section to be 
increased in length. The format of an ICS statement is shown in Figure 
15. An ICS statement must te placed at the front of the file or TEXT 
file. 


Column | Contents 


X*02* (12—2—9 punch). 
Identifies this as a loader control statement. 


( ( 
l { 
{ { j 
| i | 
| | i 
| 2-& | IcS — identifies the type of load statement. l 
l | y 
| 5—16 | Blank. | 
j \ { 
1 17-22 | Control section name — left—justified in these columns. i 
| [ | 
{ 23 | Blank. | 
| [ l 
| 24 ls. (comma). | 
i ( i 
| 25-28 | Hexadecimal length in bytes of the control section. This | 
i | must not be less than the actual length of the previously | 
| | specified control section. It must be right-—justified in | 
4 | columns with unused leading columns filled with zeros. | 
| i ( 
j 29 | Blank. j 
| l j 
| 30-72 | May be used fcr comments or left blank. ; 
l l l 
1 73-80 {| Not used by the loader. You may leave these columns blank | 
{ 4 i 


Or insert program identification for your own convenience. 
re er re 


Figure 15. ICS Statement Format 
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Note: Only six characters can be coded for the CSECT name in the ICS 
statement, but the loader compares eight characters to the CSECT nane 
from the TEXT file. 


set Location Counter (SLC) Statement: The SLC statement sets’ the 
location counter used with the loader. The file loaded after the SLC 
Statement is placed in virtual storage beginning at the address set by 
this SLC statement. The SLC statement has the format shown in Figure 
16. It sets the location counter in one of three ways: 


1. With the absolute virtual address specified as a hexadecimal number 
in columns 7-12. 


2. With the symbolic address already defined as a program name or 
entry point. This is specified by a symbolic name punched in 
columns 17-22. 


3. If both a hexadecimal address and a symbolic name are specified, 
the absolute virtual address is converted to binary and added to 
the address assigned to the symbolic name; the resulting sum is 
the address to which the loader's location counter is set. For 
example, if QQO0O0F8 was specified in columns 7-12 of the SLC card 
image and GAMMA was specified in columns 17-22, where GAMMA has an 
assigned address of 006100 (hexadecinal), the absolute address in 
columns 7-12 is added to the address assigned to GAMMA giving a 
total of 0061F8. Thus, the location counter would be set to 
0061F8. 


RS rn ie te Ref ey ee TS Sa eR Ee Le Re ee a ee ee 


Column Contents 


X'*O2* (12—2-9 punch). 
Identifies this as a loader control statement. 


blank or insert program identification for your own 
convenience. 


2 
| [ 
l l 
H f ( 
; f { 
| | l 
| 2-4 | SLC — identifies the type of load statement. l 
[ f [ 
| S6 i Blank. 
l | [ 
|! 7-12 | Hexadecimal address to be added to the value of the symbol,| 
| | if any, in columns 17-22. It must be right—justified in | 
| | these columns, with unused leading columns filled with | 
| | zeros. | 
\ H | 
} 13-1€ | #£=Blank. i 
{ ; { 
| 17-22 | Symbolic name whose assigned location is used by the | 
| | loader. Must be left—justified in these columns. If blank, | 
1 | the address in the absolute field is used. | 
| l | 
| 23 |} Blank. f 
| | [ 
| 24-72 j May be used for comments or left blank. { 
| | | 
| 73-80 | Not used by the loader. You may leave these columns i 
[ l ; 
f | | 


Figure 16. SLC Statement Format 


Replace (REP) Statement: A REP statement allows instructions and 
constants to be changed and additions made. The REP statement must be 
punched in hexadecimal code. The format of a REP statement is shown in 
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Figure 17. The data in columns 17-70 (excluding the commas) replaces 
what has already been lcaded into virtual storage, beginning at’ the 
address specified in columns 7-12. REP statements are placed in the 
file either (1) immediately preceding the last statement (END statement) 
if the text deck does not contain relocatable data such as address 
constants, or (2) immediately preceding the first RLD (relocatable 
dictionary) statement if there is relocatable data in the text deck. If 
additions made by REP statements increase the length of a _ control 
section, an ICS statement, which defines the total length of the control 
section, must be placed at the front of the deck. 


Dr ae ee ee ee eG EE OR Se ee ee ee ee ge 
Column | Contents 


1 X*O02* (12—2-9 punch). 


Identifies this as a loader control statement. 


i ; 
| | 
| i | 
| f i 
i | 
{ 2-4 | REP — identifies the type of load statement. | 
| | { 
i 5—6 | Blank. i 
i [ l 
1 7-12 | Hexadecimal starting address of the area to be replaced as | 
( | assigned by the assembler. It must be right-—justified { 
| | in these columns with unused leading columns filled with | 
| | zeros. | 
[ | | 
1 13-14 | £=Blank. J 
H [ | 
| 15-16 | ESID (External Symbol Identification) — the hexadecinal [ 
| | mumber assigned to the control section in which replacement | 
| | is to be made. The LISTING file produced by the compiler | 
( | or assembler indicates this number. | 
i | | 
{1 17-70 | A maximum of 11 four—digit hexadecimal fields, separated by| 
| {| commas, each replacing one previously loaded halfword (two | 
| | bytes). The last field must not be followed by a comma. | 
{ | l 
| 71-72 | #£=x~Blank. | 
| | I 
{| 73-80 | Not used by the loader. This field may be left blank or | 
l | ( 


program identification may be inserted. 
SSS ee ee 


Figure 17. REP Statement Format 


Set Page Boundary (SPB) Statement: An SPB statement instructs the loader 
to update the location counter to point to the next page boundary. The 
SPB statement has the format shown in Figure 18. This statement can be 
placed before, between, or after object modules or other control 
statements. 


a ae ee eg NEE Ge ee OR ae OF ge ee we ee ee en ge ee On eS ees ea Gee Seen Ee 
Column | Contents 


1 K'O02* (12—2-9 punch). 
Identifies this as a loader control statenent. 


2-4 SPB — identifies the type of load statement. 


5—80 May be used for comments or left blank. 


Figure 18. SPB Statement Format 
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Responses 
DMSLIO74OI EXECUTION BEGINS... 


START was specified with LOAD and the loaded program starts 
execution. Any further responses are from the progran. 


INVALID CARD - xxx...Xxx 


INV was specified with LOAD and an invalid statement was found. 
The message and the contents of the invalid statement (xxx... xxx) 
are listed in the file LOAD MAP. The invalid statement is ignored 
and loading continues. 


Other Messages and Return Codes 


DMSLGTOOQ2I FILE ‘fn TXTLIB* NOT FOUND RC=0 

DMSLIOOOQIE NO FILENASE SPECIFIED RC=24 

DMSLIOOO3E INVALID OPTION ‘option! RC=24 

DMSLIOOOSE NO toption! SPECIFIED RC=24 

DMSLIOO2Z1E ENTRY POINT ‘name* NCT FOUND RC=40 

DMSLIOO29E INVALID PARAMETER ‘parameter' IN THE OPTION ‘option' FIELD RC=24 

DMSLIOO55SE NO ENTRY POINT DEFINED RC=40 

DMSLIOOS6E FILE ‘fn ft" CONTAINS INVALID [NAME|ALIAS|ENTRY| ESD] RECORD 
FORMATS RkC=32 

DMSLIOOS9E CMS/DOS ENVIRONMENT ACTIVE RC=40 

DMSLIO104S ERROR ‘nn! READING FILE ‘fn £t fm" FROM DISK RC=100 

DMSLIO105S ERROR ‘nn' WRITING FILE ‘fn ft fm" ON DISK RC=100 

DMSLIO109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 

DMSLIO116S LOADER TABLE OVERFLOW RC=104 

DMSLIO168S PSEUDO REGISTER TABLE OVERFLOW RC=104 

DMSLIO169S ESDID TABLE CVERFLOW kC=104 

DMSLIO201W THE FOLLOWING NAMES ARE UNDEFINED: RC=4 

DMSLIO2Z02W DUPLICATE IDENTIFIER ‘identifier' RC=4 

DMSLIO203W "SET LOCATION COUNTER" NAME ‘name* UNDEFINED RC=4 

DMSLIO2Z06W PSEUDO REGISTER ALIGNMENT ERROR RC=4 

DMSLI0O623S MODULE CANNOT BE LOADED AT LOCATION ‘location' BECAUSE IT 
WOULD OVERLAY THE CMS NUCLEUS RC=88 

DMSLIO907T I/O ERROR ON FILE ‘fn £t fm* RC=256 

DMSSTTO62E INVALID * IN FILEID kRC=20 
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LOADLIB 


Use the LOADLIB command to 1ist, copy, or compress a CMS LOADLIB. CMS 
LOADLIBs can be merged, and specified members can optionally be selected 
or excluded during the merge. ‘The format of the LOADLIB command is: 


r a | 
LOADLIB | |LIST | [£ileid2 [£fileid3]] [ (options...[) ]] 
[COMPRESS fileid1| 
| COPY | 
L J 
r 71 r a | 
options: | TERM | | REPLACE| 
| PRINT| [MODIFY | 
[DISK | L J 
L J 


SYSIN control statements (COPY function only): 


“ 
| SELECT 


a 

| 
| EXCLUDE | 
L J 


eee ee et 
om Geet ame ogee eee eo eee ee es ee eae ee 
a= oe ee oa ee oe so eee ee ee eee 


LIST lists by member name, the contents of the CMS LOADLIB 
Specified by fileid1, and gives a hexadecimal representation 
of each member's size. 


COMPRESS recreates a LOALLIB with the same name as the specified file 
(fileid1l), and deletes all obsolete members from the new data 
set. 


COPY copies members of fileid1 into fileid2. If fileid2 already 
exists, MODIFY or REPLACE must be specified. If you specify 
MODIFY, existing members are not replaced in the output data 
set, but new memkers are added. If you specify REPLACE, 
existing members are replaced in the output data set and new 
members are added. 


You must specify SYSIN control statements. If you do not 
specify SYSIN control statements in a SYSIN dataset (fileid3), 
you will be prompted for them at the terminal with the 
message: “ENTER:" 


Note: You may specify the LOADLIB function (LIST, COMPRESS, COPY) either 
on the command line or in the SYSIN data set (fileid3). If you specify 
the function in the SYSIN data set, you must issue the FILEDEF command 
for fileidl, fileid2 (if required), and fileid3 before you issue the 
LOADLIB command. However, if you specify the function on the command 
line, fileid1, and optionally, fileid2 and fileid3 may be specified 
either on the command line or defined via FILEDEF commands. Any FILEDEF 
commands issued by the user remain in effect after the command function 
completes. During subsequent use of LOADLIB functions, file definitions 
which have not been cleared or reissued may override the file 
identifiers entered in the LOADLIB command line. 


fileid'1 is the filename, filetype, and filemode of the input LOADLIB. 
This data set is referred to as the SYSUT1 data set. SYSUT1 
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is always required. An OS load library may not be specified 
as input. 


fileid2 is the filenane, filetype, and filemode of the output LOADLIB. 
This data set is referred to as the SYSUT2 data set. If the 
SYSUT2 data set already exists, either MODIFY or REPLACE must 
be specified. If a SYSUT2 data set is not specified, LOADLIB 
SYSUT2 A (or the filemode of the first available read/write 
disk) is the default. When the default SYSUT2 file is used 
and no errors occur, fileidl is erased andthe new file is 
renamed fileid1?. SYSUT2 is ignored for the LIST or COMPRESS 
functions. 


fileid3 is the filename, filetype, and filemode of the control data 
set. This data set 1s referred to as the SYSIN data set. If 
no SYSIN data set is specified, the user iS prompted at the 
terminal to enter LOADLIB functions or SYSIN COPY control 
statements. 


Options entered in the command line: 


> EE A RO 


TERM directs priater output to the terminal. TERM is the default. 
PRINT directs printer output to the printer. 
DISK directs printer output to disk. The DISK option creates a 


file named LOADLIB LISTING *, where "*" is the filemode of the 
first available read/write disk. 


REPLACE replaces existing members of a data set and adds new nembers. 
MODIFY does not replace existing members of a data set; adds new 


nembers. 


SYSIN control 


SELECT copies only selected members of a data set. Each member to be 
copied must te named in a separate line entry following the 
SELECT statement. Note that if you specify the SELECT 
statement, the LOADLIB command does not replace existing 
members of a data set. If you want to replace an existing 
member of a data set, you must specify (R) immediately 
following the member name. 


EXCLUDE copies a whole data set except for a few members. Each member 
to be excluded must be named in a separate line entry 
following the EXCLUDE statement. 


Note: Indicate the end of control statements from the terminal by 
entering a null line; EOF serves this purpose ina SYSIN file. If you 
want to copy an entire data set, specify COPY and enter a null line at 
the terminal (or include a blank line in a SYSIN file). To avoid 
unexpected results, clear the file definitions used by the COPY function 
before specifying new file identifiers in subseguent LOADLIB commands. 


Responses 


MEMBER — member name HAS BEEN COPIED 

MEMBER - member name HAS BEEN REPLACED IN DATA SET 

MEMBER - wember name DOES NOT EXIST EUT HAS BEEN ADDED TO DATA SET 
REPLACE was specified but the member was not in the output data 
set, therefore the member was added to the output data set. 
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MEMBER —- member name COPY UNSUCCESSFUL 
An error occurred while trying to add/replace the member in the 


output data set. 
member 


already existed in the output data _ set.) 


continues with the next member to be copied. 


MEMBER - 


member name NOT FCUND 


The member requested was not found in the input data set. 


MEMBER - 
MEMBER —- 
USER TIR 
NOTE 


Messages and Return 


DMSUTLOO3E 
DMSUTLO 14E 
DMSUTLO24E 
DMSUTLO32E 
DMSUTLO39E 
DMSUTLO4Y2E 
DMSUTLO4TE 
DMSUTLOSUE 
DMSUTLO65E 
DMSUTLO66E 
DMSUTLO73E 
DMSUTL9YOIT 


DMSUTLOO7T 


member name NOT COPIED. 
member name NOT COPIED. 
WAS NOT UPDATED 

LIST TTR OR RECORD WAS NOT UPDATED 


WRONG LENGTH NOTE LIST FOUND. 
NOTE LIST UPDATE LOGIC ERROR. 


Codes: 
INVALID OPTION 'option' RC=24 
INVALID FUNCTION ‘function! RC=24 
FILE ‘fin ft fm" ALREADY EXISTS RC=28 
INVALID FILETYPE 'filetype" RC=24 
NO ENTRIES IN LIBRARY ‘fn ft fm" RC=32 


NO FILEID(S) SPECIFIED RC=24 

NO FUNCTION SPECIFIED RC=24 

INCOMPLETE FILEID SPECIFIED RC=24 

"option® OPTION SPECIFIED TWICE RC=24 
"option! AND ‘option ARE CONFLICTING OPTIONS 
UNABLE TO OPEN FILE ddname RC=28 

UNEXPECTED ERROR AT "addr': PLIST "plist fn f£t fm' 
AT *addr', EASE: *‘addr', RC nn RC=256 

I/O ERROR ON FILE 'fn ft fam! RC=256 


RC=24 
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The 


COPY 


LOADMOD 


LOADMOD 


Use the LOADMOD command to load a MODULE file into storage. The file 
must be in nonrelocatable format as created by the GENMOD command. The 
format of the LOADMOD command is; 


SSS ee en 
| LOADMod | £n [MODULE [fn]] | 


| | ae | 


where; 

fn is the filename of the file to pe loaded into storage. The 
filetype must be MODULE. 

fn is the filemode of the module to be loaded. If not specified, 
Or specified as an asterisk, all your disks are searched for 
the file. 


Usage Notes 


1. You can use the LOADMOD command when you want to debug a CMS MODULE 


file. After the file is loaded, you may set address stops or 
breakpoints before you begin execution with the START command; for 
example; 


loadmod progl 
cp adstop 210ae 
start 


2. If a MODULE file was created using the DOS option of the GENMOD 
command, the CMS/DOS environment must be active when it is loaded. 
If it was created uSing the OS option (the default), the CMS/DOS 
environment must not be active when it is loaded. 


3. MODULE files created with the ALL option, or with SYSTEM option and 
loaded into the transient area, may be loaded regardless of whether 
the CMS/DOS environment is active. If the LOADMOD command is 
called from a program, the loading is also done regardless of 
whether the CMS/DOS environment is active. 


Responses 


None. 


Messages and Return Codes 


DMSMODOO1E NO FILENAME SPECIFIED RC=24 

DMSMODOO2ZE FILE 'fn ft" NCT FOUND RC=28 

DMSMHODO0O32E INVALID FILETYPE ‘ft! RC=24 

DMSMODO7OE INVALID PARAMETER 'parameter' kC=24 

DMSMOD104S ERROR 'nn* READING FILE ‘fin ft fm' FROM DISK RC=100 

DMSMOD109S VIRTUAL STORAGE CAPACITY EXCEEDED Rc=104 

DMSMODII4E "fn ft fm" NOT LOADED; CMS/DOS ENVIRONMENT [NOT] ACTIVE 
RC=40 or RC=-0005 

DMSMOD116S LOADER TABLE OVERFLOW RC=104 

DMSSTTO4SBE INVALID MODE ‘mode! RC=24 
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Use the MACLIB command to create and modify CMS macro libraries. The 
format of the MACLIB command is: 


GEN 
ADD litname fni{[fn2...] 
REP 

DEL libname nembernanel[ membernanme2... ] 
COMP libname 


MAP likname [ (options...[) ]] 


unere: 

GEN generates a CMS macro library. 

ADD adds members to an existing macro library. No checking is 
done for duplicate names, entry points, or CSECTS. 

REP replaces existing members in a macro library. 

DEL deletes members from a macro library. If more than one member 
exists with the same name, only the first entry is deleted. 

COMP compacts a macro library. 

MAP lists certain information about the members in a macro 


library. Available information includes member name, _ size, 
and location relative to the beginning of the library. 


libnane is the filename of a macro library. If the file already 
exists, it must have a filetype of MACLIB; if it is being 
created, it is given a filetype of MACLIB. 


fn1 [fn2...] 
are the names of the macro definition files to be used. A 
Macro definition file must reside on a CMS disk and its 
filetype must be either MACRO or COPY. Each file may contain 
one Or more macros and must contain fixed-length, 80-character 
records. 


nembernaneil[ nmembername2... ] 
are the names of the macros that exist in a macro library. 


MAP Options: The following options specify where the output of the 
MAP function is sent. Only one option may be specified. If more 
than one option is specified, only the first one given is used. 


TERM displays the MAP output at the terminal. 
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DISK writes the MAP output on a CMS disk with the file identifier 
of "libname MAP A1". If a file with that name already exists, 
the old file is erased. If no option is specified, DISK is 
the default. 


PRINT writes the file "libname MAP A1" to your A-disk and spools a 
copy to the virtual printer. 


Usage Notes 


1. When a MACRO file is added to a MACLIB, the membername is taken 
from the macro prototype statement. If there is more than one 
Macro definition in the file, each macro is written into a separate 
MACLIB member. 


If the filetype is COPY and the file contains more than one macro, 
each macro must be preceded by a control statement of the following 
format: 


*COPY membername 


The name on the control statement is the name of the macro when it 
is placed in the macro library. If there is only one macro in the 
COPY file and it is not preceded by a COPY control statement, its 
Mame (in the macro library) is the same as the filename of the COPY 
file. If there are several macro definitions ina COPY file and 
the first one is not preceded by a COPY control statement, the 
entire file is treated as one macro. 


2- If any MACRO file contains invalid records hetween members, the 
MACLIB command displays an error message and terninates. Any 
members read before the invalid card is encountered are already in 
the MACLIB. The MACLIB command ignores CATAL.S, END, and /* 
records when it reads MACRO files created by the ESERV progran. 


3. If you want a macro library searched during an assembly or 
compilation, you must identify it using the GLOBAL command before 
you begin compiling. 


4%. The MACLIBs distributed with the CMS system are: CMSLIB, OSMACRO, 
OSMACRO1, TSOMAC, and DOSMACRO. 


5. The TERM or PRINT options will erase the old MAP file, if one 
exists. 


6. If you delete the last remaining member of a maciib, the maclib is 
erased. 


Responses 


When you enter the MACLIB MAP command with the TERM option, the names of 
the library members, their sizes, and their locations in the library are 
displayed. 


MACRO INDEX SIZE 
hnane loc size 
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Other Messages and Return Codes 


DMSLBMOOTE 
DMSLBMOO02E 
DMSLBMOO2W 
DMSLBMOO3E 
DMSLBMO13W 
DMSLBMO14E 
DMSLBMO37E 
DMSLBMO4E6E 
DMSLBMO4TE 
DMSLBMOS6E 
DMSLBMO69E 
DMSLBMO70OE 
DMSLBM104S 
DMSLBM105S 
DMSLBM109S 
DMSLBM157S 


DMSLBM1675S 
DMSLBM213W 
DMSLBMYO7T 


NO FILENAME SPECIFIED RC=24 

FILE ‘fn f£t' NCT FOUND RC=28 

FILE 'fn £t [f£mj]* NOT FOUND RC=4 
INVALID OPTION ‘option' RC=24 
MEMBER 'name* NCT FOUND IN LIBRARY 
INVALID FUNCTION "function RC=24 
DISK 'mode' IS READ/ONLY RC=36 

NO LIBRARY NAME SFECIFIED RC=24 


"fn ft fm*' RC=4 


NO FUNCTION SPECIFIED RC=24 

FILE 'fn ft £m' CONTAINS INVALID RECORD FORMATS RC=32 

DISK ‘mode NOT ACCESSED RC=36 

INVALID PARAMETER ‘parameter' RC=24 

ERROR ‘nn" READING FILE ‘fn ft fm" FROM DISK RC=100 

ERROR ‘nn! WRITING FILE ‘fn ft fm' ON DISK RC=100 

VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 

MACLIB LIMIT EXCEEDED[, LAST MEMBER NAME ADDED WAS 
"membernanme'] RC=88 

PREVIOUS MACLIB FUNCTION NOT FINISHED RC=88 


LIBRARY 'filenane'* OR ERASED IF 


I/O ERROR ON FILE 'fn ft fun' 


MACLIE NOT CREATED, 
RC=256 
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MAKEBUF 


MAKEBUF 


Use the MAKEBUF command to create a new buffer within the program stack. 
The format of the MAKEBUF command is: 


a eT aE we ee ey ye eg Gee eee gee Oe SE ee eee ey a eg ne vonage er 
{ MAKEBUF | | 


ee ee | 


Usage Notes 


1. When you issue a MAKEBUF command, CMS returns as a return code the 
humber of the program stack buffer ‘just created. If you issue a 
MAKEBUF command in an EXEC that has the &SERROR statement in effect, 
the MAKEBUF return code causes the &ERROR statement to execute. 


2- Use the WAITRD function to read lines from the buffers the MAKEBUF 
command creates. WAITRD first reads lines from the most recently 
created buffer. When the most recent buffer is exhausted, WAITRD 
reads the next post recent buffer. When all program stack buffers 
are exhausted, WAITRD reads from the terminal input buffer. 
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2. To copy an entire OS partitioned data set into individual CMS 
files, you could enter: 


filedef test2 disk sys1 maclib b 
filedef macro disk 
movefile test2 macro (pds 


These commands copy members from the OS partitioned data set 
SYS1.MACLIB or the CMS file SYS1 MACLIB into separate files, each 
with a filename equal to the membername and a filetype of MACRO. 
Note that the output ddname was not specified in full, so that CMS 
assigned the default file definition (FILE ddname). 


3. You cannot copy VSAM data sets with the MOVEFILE command. 


4. The MOVEFILE command does not support data containing spanned 
records. Use of spanned records results in the error message 
DMSSOPO36E and an error code of 7. 


5. To copy anentire partitioned data set into another partitioned 
data set, use the COPYFILE command. If an attempt is made to use 
the MOVEFILE command without the PDS option for a partitioned data 
set, only the first member is copied and an end—of-file condition 
results. The resultant output file will contain all input records, 
including the header, until the end of the first member. 


6. When uSing the MOVEFILE ccmmand to move members from CMS maclibs, 
note that each member is followed by a // record, which is a maclib 
delimiter. You can edit the file to delete the // record. 


7. Since Vil knows the real device characteristics of a tape unit, 
some of the options specified in the FILEDEF command may be ignored 
when performing I/0 operations to a tape unit. For example, in 
uSing FILEDEF, if you specify a ddname of 7TRACK and a density of 
200 and the real device is a 3420 Model 5, VM writes at STRACK and 
density of 1600. 


8. If you use the MOVEFILE command and FILEDEF command with the 
options DISP MOD and RECFM FB to add a file to the endof an 
existing OS simulated file, the user should erase the end—of-—fiile 
mark at the end of the existing file. The end—of-—file mark will be 
present only if the last physical record written was a short block. 


9. The following record formats are supported for DOS files on FBA 
device: fixed, fixed blocked, variable, variable blocked, and 
undefined. The FILEDEF for the input file pust specify at least 
the RECFM and BLOCK; for fixed block files the LRECL must also be 
specified. 


Default Device Attributes 


If a record format (RECFM), Elocksize (BLOCK), and logical record length 
(LRECL) are specified on the FILEDEF command, these values are used in 
the data control blcck (DCB) defining the characteristics of the move 
operation. If the FILEDEF was issued without a record format or 
blocksize specified, these values are determined according to the 
defaults listed in Figure 19. If the blocksize was aot specified, the 
default blocksize is used. If the logical record length was not 
specified, the default logical record length is determined as follows: 
for an F or U record format, the logical record length equals the 
blocksize; for a V record format, the logical record length equals the 
blocksize minus 4. 
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Oo 


input ddnamej| input ddnane 


1If the default record format and blocksize are used ina 
tape—to-tape move operation and an input record is greater than 3600 
bytes, it is truncated to 3600 bytes on the output tape. 

2Not applicable. 


a ee 
Figure 19. Default Device Attributes for MOVEFILE Command 


| i Input ddname | Output ddname i 
| l SS — i 
i Device i RECFM | Blocksize | RECFMA | Blocksize | 
( | ; 
| Card Reader | F | 80 | NA2@ [ NA2 i 
| l | i ; l 
{| Card Punch | NA2 l NA2 | F i 80 l 
| ( l | { | 
| Printer [ NA@ | NA2 | U | 132 | 
: l l | | | 
{| Terminal { U | 130 | U i 130 | 
| [ | { ; 4 
{| Tape! { U | 3600 | RECFM of |Blocksize of | 
| | | | input ddname| input ddname | 
| l l | | | 
| Disk file J|RECFM of |Blocksize of | RECFM of |Blocksize of i 
| | file | file | input ddnane| input ddnane | 
| i j l ; l 
{| Dummy | NA@ ; NA2 | RECFM of | Blocksize of | 
l { | ; | 
l i 
; y 
| | 
| | 
| | 


Responses 


DMSMVE225I PDS MEMBER ‘membername* MOVED 
The specified member of an OS partitioned data set was moved 
successfully to a CMS file. This response is issued for each 
member moved when you use the PDS option. 

DMSMVE226I END OF PDS MCVE 


The last member of the partitioned data set was moved successfully 
to a CMS file. 


DMSMVE7061I TERM INPUT -—- TYPE NULL LINE FOR END OF DATA 
The input ddname in the MOVEFILE specified a device type of 
terminal. This message reguests the input data; a null line 
terminates input. 


DMSMVE7O8I DISK FILE ‘FILE ddname A1* ASSUMED FOR DDNAME ‘ddname* 


No file definition is in effect for a ddname specified on the 
MOVEFILE command. The MOVEFILE issues the default FILEDEF command: 


FILEDEF ddname CLISK FILE ddname Al 


If file ddname does not exist for the input file, MOVEFILE 
terminates processing. 
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Other Messages and Return Codes 


DMSMVEOO2E 
DMSMVEOO3E 
DMSMVEO37E 
DMSMVEO4I1E 
DMSMVEO69E 
DMSMVEO7OE 
DNSMVEO73E 
DMSMVEO75E 
DMSMVEO86E 
DMSMVE127S 
DMSMVE128S 


DMSMVE129S 


DMSMVE130S 
DMSMVE232S 
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FILE 'fn ft fm' NCT FOUND RC=28 

INVALID OPTION 'option' RC=24 

OUTPUT DISK ‘mode* IS READ/ONLY RC=36 

INPUT AND OUTPUT FILES ARE THE SAME RC=40 
OUTPUT DISK 'mode't IS NOT ACCESSED RC=36 
INVALID PARAMETER "parameter' RC=24 

UNABLE TO OPEN FILE ddname RC=28 

DEVICE ‘device name' ILLEGAL FOR {INPUT|JOUTPUT} 
INVALID DDNAME '‘ddname* RC=24 
UNSUPPORTED DEVICE FOR ddname RC=100 
I/O ERROR ON INPUT AFTER READING nnnoa 
code ON ddname RC=100 

I/O ERROR ON OUTPUT WRITING RECORD NUMBER nnnn: 
code ON ddname RC=100 

BLOCKSIZE ON V FORMAT FILE ddname IS LESS THAN 8 
INVALID RECFM -- SPANNED RECORDS NOT SUPPORTED 


RC=40 


RECORDS: INPUT ERROR 
OUTPUT ERROR 


RC=88 
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Use the NAMEFIND command to display information from a names file, or to 
place that information in the program stack (for use by an EXEC or other 


progran). 


A names file has a filetype of NAMES and must be in the format described 
in the usage note below, "Format cf a Names File". A “userid NAMES" 
file is a special names file, used by the NASES, NOTE, SENDFILE, 
RECEIVE, and TELL commands, that makes it easier for you to communicate 
with other computer users. You can use the NAMES command to create a 
“userid NAMES" file. NAMEFIND searches a “userid NAMES" file, unless a 
different filename is specified. 


The format of the NAMEFIND command is: 


[NAMEFind| :tag value [:tag [ value]]... [ (options...[) ]] | 
| | { 
| | options: | 
l l r 1 l 
l | [STACK [n/*| 1 ] [ FIFO {LiFO] | [File fn J | 
| | {FIFO [n[*| 1 ] | [LiNenun ] I 
| | JLIFO [nlil*| 1 ] | [STARt recnun 1 1 
| | TEPE Lni*¥|] 1 ] [| [SIze [ni*i 8 Jj 1 

2 l 


where: 

stag is a tag in a names file. You can specify multiple tags ina 
NAMEFIND command. The maximum length of atag is 255. For 
more information on tags, see the usage note, "Format of a 
Names File". 

value is the value of a tag in a names file. The maximun length of 
a value is 255. 

Qptions: 


STACK [n] [ FIFO|LIFO] 

means that informaticn from the number of entries specified 
(n) that meet the search criteria is placed in the progran 
stack, rather than being displayed at the terminal. The 
Humber (n) specified is the number of entries containing 
Matching information. If n is omitted, the default is one 
(1). If an asterisk (*) 1s specified, information from all 
the entries meeting the search criteria is stacked. The 
information is stacked either FIFO (first in first out) or 
LIFO (last in first out). The default order is FIFO. 


FIFO n specifies that the information is placed in the console stack. 
The options STACK, STACK FIFO, and FIFO are all equivalent. 


LIFO n Specifies that the information is placed in the console stack 
rather than being displayed at the terminal. The information 
is stacked LIFO (last in first out). This option is 


equivalent to STACK LIFO. 


TYPE on means that information from the number of entries specified 
(n) that meet the search criteria is displayed at _ the 
terminal. The number (n) specified is the number of entries 
containing matching information. If n is omitted, the default 
is one (1). If an asterisk (*) is specified, information fron 
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all the entries meeting the search criteria is displayed. 


FiLe fn specifies a file whose filename is "fn" and whose filetype is 


"NAMES". This option allows you to use NAMEFIND to search a 
names file whose filenane is something other than your userid. 
If this option is not specified, the file "userid NAMES *" is 
searched. 


LINenun requests that the record number of the beginning of the entry 


be displayed or stacked. It is displayed or stacked before 
any of the other information. 


STARt recnun 


specifies that the search is to begin at the "recnum" record 
of the file. 


Size n Specifies the maximum size of a buffer where a names file is 


kept. The size of the buffer is an, where h is in 
1024-character units. Valid values for n are 0-99999999 or *, 
If zero (0) is specified, no buffer is used, and the names 
file is read into storage each time NAMEFIND is invoked. If 
an asterisk (*) is specified, the buffer is as large as the 
names file requires. If no SIZE option is specified, SIZE 8 
(8192 characters) is the default. This represents the maxinun 
size of the buffer. (If the names file is smaller than 8192 
characters, a smaller buffer is used.) This option improves 
the performance of NAMEFIND when a names file is large. For 
more information on its use, see the usage note, "Using the 
SIZE Option", below. 


Usage Notes 


1. 
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Format of a Names File 


A names file is a collection of entries, with each entry identified 
by a "nickname". A nickname tag plus a series of other tags with 
associated values make up,an entry. 


A special names file is one whose fileid is "userid NAMES", which 
can be created using the NAMES command. A “userid NAMES" file 
contains entries for other computer users and entries for lists of 
users. An entry contains the information necessary to communicate 
with that person. Once you create a "userid NAMES" file, you can 
prepare notes for and send files and messages to other people just 
by using their "nicknames" as operands in the NOTE, SENDFILE, and 
TELL commands. The tags in each entry supply the additional 
information required to perform these functions. 


You can add, remove, or change entries in the “userid NAMES" file 
either by using the NAMES command (which displays a menu), or by 
editing the "userid NAMES" file directly. (The NAMES command can 
be used only for a file whose fileid is “userid NAMES".) 


A sample "userid NAMES" file is shown below, in the "Examples" 
section. 


Format of Entries in a Names File 


—— = ===> 


The format of data lines in a names file is as follows: 


a a a 
|:tag.value [ :tag.value... ] | 
ee 8 ee EE E—E——————————— Eee eee eee 


The value need not be on the same record as its tag and can 
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continue onto the next record. 
The only tag that is required is a :NICK tag: 


ee ee, eg ee ee a ee eg ee ee 
j:NICK.nicknane | 
Mn a ee ee ee eee 


This is the primary tag, one for each entry. It identifies the 
beginning of an entry and must be the first word on a line. 


Any tags that follow relate to the preceding :NICK tag. The 
maximum number of tags with values for a given :NICK entry is 64. 
Therefore, between :NICK entries, you can have from zero to 63 
tags. 

In addition, 


BSG eon i eg en fees a te per ee Pee ee, ee ee mee ee ere eT eye Ce Sere gS ee eee 
| * An asterisk begins a comment line. | 


[ Blank lines are ignored. i 
a ee ee a eo a ee ee | 


How NAMEFIND Searches a Names File 

When you issue a NAMEFIND command, each tag specified with a value 
is a search tag. NAMEFIND searches until all search tags are found 
in an entry. Each tag specified without a value is a "return" tag, 
whose value is returned. If no return tags are specified, the 
entire entry is displayed or stacked. 


Given the "userid NAMES" file shown in the "Examples" section 
below, the command 


NAMEFIND :NICK SNOW : NAME :PHONE 
would display: 


Snow White 
LLL-LLL2Z 


{:NICK SNOW is the search tag. 
sNAME and :PHONE are the return tags.) 


You can specify the tag ":LIST" to display all the names ina list. 
For example, the command 


NAMEFIND sNICK DWARFS :LIST 
would display: 

SNOOZY DUMMY BOSS SMILEY GROUCHY SNIFFLES WISTFUL 
You could then issue NAMEFIND for each of the names in the list 
shown above, specifying the return tag :USERID to retrieve the 
userid of each person. 
You need know the value of only one unigue tag in an entry for that 
entry to be located. The tags specified without values determine 
the information that is displayed (or stacked). For example, the 
command 


NAMEFIND :sUSERIT QUEEN :NICK 


would display: 
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WITCH 


If duplicate entries exist in a names file, only the first is 
found, unless an option value (n) greater than one is specified. 
If duplicate :NICK entries are submitted from the NAMES menu (which 
is displayed with the NAMES command), a warning message is 
displayed. 


Case and multiple blanks are ignored during the search. Case and 
Multiple blanks in tag values are preserved when the values are 
displayed or stacked. 


Tags in a “userid NAMES" File 


The CMS commands that reference a "userid NAMES" file are NOTE, 
SENDFILE, TELL, and RECEIVE. These commands make use of the tags 
described below. Fields that corresfond to these tags appear on 
the NAMES menu. You can also add other tags to the file (for 
example, for use by other applications). 


Sa RS Ra || 
|: NICK.nicknane | 
a ee a a eS a ee 


This is the primary tag, one for each person or list in the file. 
It identifies the beginning cf an entry and must be the first word 
on a line. 


You should have a :NICK entry for yourself, because the tags that 
Supply your address, fhone number, etc., are used by the NOTE 
command to generate note headings. 


All of the following tags relate to the preceding :NICK tag. (Not 
all tags are reguired for each entry; however, the CMS conmands 
that reference the "userid NAMES" file make use of the following 
tags.) 


SSS ee eS en 
|: USERID.userid | 
a RN a a SN ee ey ee eee eee | 


Specifies the userid of the preceding :NICK entry. This tag is 
required for communicating with this user via NOTE, SENDFILE, and 
TELL. If no :USERID tag is specified, the nickname is just an 
entry (for an address list, or perhaps a name of someone who does 
not use a computer). 


Se eS ae 
|: NODE.node | 
aa a ae ea Ee eee | 


specifies the node of the preceding :NICK entry. If no node is 
specified, the default node is your node. 


oa ee 
|: NOTEBOOK.filenane l 
, CR en a aa a ee 


is the name of a file whose filetype is NOTEBOOK, in which notes 
(prepared by the NOTE command) sent to or received from this person 
are kept. See the NOTE command for more information on keeping 
notes. 
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ee TT eg ey eT ee ES Op ST ee 
|: NAME.nane | 
On a ee ee eee ee 


is the person's real Dane. 


TT re ge RT ge ee a ag Oe a eg er a eS a ey ga ee ee pee aan, ) See ee ee 
{:PHONE.phone number [ 
—— —————— ee rr ee 


is the person's phone number. 


Regt ae eS ee ee Ge ewe pee ee ee ee ee ee eee 
|: ADDR.address | 
cE ee ee | 


is the person's postal address. Semicolons (;) in the tag's value 
separate the lines of the address. They do not appear in the 
header of a note (prepared by the NOTE command). 


eg ee ET ae A TE Ee a ee ge A ee eS ee Soe 
|:LIST.[ name... ] | 
En ee a ee | 


is a list of names. If a name in the list is not a nickname in the 
"userid NAMES" file, it is assumed to be a userid on the sender's 
computer. A name can also be specified as "userid AT node", just 
aS it can in the NOTE, SENDFILE, and TELL commands. The nickname 
specified on the associated :NICK tag can be the nickname for the 
whole list, or it can be the nickname for one user. 


Using the SIZE Option 


When NAMEFIND is invoked, the names file is read into a buffer in 
virtual storage. It is kept in this buffer instead of being read 
from disk each time NAMEFIND is invoked. The CMS conmands NOTE, 
RECEIVE, SENDFILE, and TELL allinvoke the NAMEFIND command to 
search a names file. Having a names file kept in a buffer improves 
performance of these commands, particularly if the file is large. 


If no SIZE option is specified, the default buffer size is SIZE 8 
(8192 characters). If a names file is too large to fit in the 
buffer, the size of the buffer can be increased accordingly. 
Naturally, it can also be decreased to conserve virtual storage. 
However, if the names file is larger than the size (n) allocated for 
the buffer, NAMEFIND reads as much of the file as will fit into the 
buffer, and then reads the rest from disk. By specifying "NAMEFIND 
(SIZE *" (a good candidate for your PROFILE EXEC), the buffer uses 
as much storage as is needed to contain a names file, no more and no 
less. 
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Error Messages and Return Codes 


DMSNAMOO2E 
DMSNAMO03E 
DMSNAM029E 


DMSNAM104S 
DMSNAM156E 


DMSNAM618E 
DMSNAM621E 


DMSNAM622E 
DMSNAM622W 


DMSNAM633E 


DMSNAM634E 
DMSNAM635I1 


DMSNAM6364 
DMSNAM637E 


Examples 


FILE 'fn £t fm' NOT FOUND. RC=28 
INVALID OPTION "option. RC=24 
INVALID PARAMETER ‘parm' IN THE OPT 
RC=24 

ERROR 'nn' REALING FILE 'fn ft fnm'* 
RECORD ‘nnn* NOT FOUND - FILE ‘fn f 
RECORDS RC=32 

NUCEXT FAILED. RC=13 

BAD PLIST: NAMEFIND MUST BE INVOKED 
EXTENSION. RC=24 


INSUFFICIENT STORAGE 


FOR NAMEFIND. 


ION ‘option! FIELD. 


FROM DISK. kRC=100 
t fm' HAS ONLY ‘nnn' 
AS A NUCLEUS 


RC=41 


INSUFFICIENT FREE STORAGE FOR NAMEFIND BUFFER, 


PROCE 
TOO 4M 
LINE. 


NO VALUE TO SEARCH FOR WAS SPECIFIED. 


NO EN 


CRITERIA. 


RETUR 


MISSING VALUE FOR THE ‘'orftion' 


SSING CONTINUES. 
ANY TAGS WERE ENCOUNTERED. 
RC=88 


TRIES WERE FOUND THAT MATCHED 
RC=32 
NED VALUES WERE TRUNCATED. RC 


OPTI 


The following is a sample "userid NAMES" file; 


MAXIMUM IS 64 PER 


RC=24 
YOUR SEARCH 


=88 


ON. RC=24 


a ee fee ge a ed ee eg NS a ee 


| 
| 
| 
| 
| 
| 
| 
i 
| 
I 
| 
| 
| 
| 
| 
| 
| 
| 
| 
d 
| 
| 
| 
l 
l 
| 
| 
| 
| 
| 
L 


Figure 20. 


snick.SNOW 


snick. BOSS 


snick.SNOOZY 


snick.DUMMY 


snick.SNIFFLES 


:nick.GROUCHY 


snick.SMILEY 


snick.WISTFUL 


snick.WITCH 


:nick.GORGEOUS 


snick.DWARFS 


Sample 


suserid.SNOWHITE 
sname.Snow White 
saddr.Forest Primeval 
suserid.SNCOZY snode.COTTAGE 
sname.I. M. Dozing 

saddr.Dwarf Cottage;Forest 
suserid. DUMMY snode.COTTAGE 
sname.S. A. What 

saddr.Dwarf Cottage;Forest 
suserid.BOSS :node.COTTAGE 
shame.T.0O.P. Banana 
saddr.Dwarf Cottage;Forest 
suserid.SNIFFLES :nodeé.COTTAGE 
sname.A. H. Choo 

saddr.Dwarf Cottage;Forest 
suserid.GROUCHY :node.COTTAGE 
shame.E. B. Scrooge 
saddr.Dwarf Cottage;Forest 
suserid.SMILEY snode.COTTAGE 
sname.H. A. Haas 

saddr.Dwarf Cottage;Forest 
suserid.WISTFUL :ncede.COTTAGE 
shame.R. U. Shy 

saddr.Dwarf Cottage;Forest 
suserid.QUEEN :node.CASTLE 
sname. Bad Queen 

saddr.Vanity Lane;Mirror City 
suserid. PRINCE :node.ATLARGE 
sname.Prince Charming 


snode.FOREST 


slist. SNOOZY DUMMY FOSS SMIL 


"userid NAMES! File 
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: phone. ZZ2-ZZ22 


: phone. 777-7777 


:phone.777-7777 


:phone.777-7777 


:phone. 777-7777 


: phone. 777-7777 


: phone. 777-7777 


:phone.777-7777 


: phone. UGLY-1111 


snotebook. PRIVATE 
:phone.Area 111 111-1111 


EY GROUCHY SNIFFLES WISTFUL 


a ee | 


NAMES 


NAMES 


Use 


the NAMES EXEC procedure to display a menu from which you’ can 


create, change, and remove entries in a “userid NAMES" file. The menu 
can be used only on a display terminal. 


The format of the NAMES command is: 


A a IS | 


Dear ee ee Ap ge ge ee ee en ee ee a Bia ot 
| NAMES | [nicknane] i 
es i NIT | 


where: 


nickname is the name assigned to an entry in a “userid NAMES" file. If 


you specify a nickname, the NAMES menu is displayed with all 
the information from that entry (if the entry exists) filled 
in on the menu. You can then examine or change the values in 
that entry. For example, you might want to update someone's 
address or phone number. 


If the entry does not exist, the menu is displayed with only 
the "nickname" field filied in (with the nickname you 
specified). You can then fill in the other fields to adda 
new entry to the NAMES file. 


If you invoke NAMES without specifying a nickname, the menu is displayed 
with all fields left blank. You can then “fill in the blanks" on the 
menu to create a new entry, or you can scroll through the names file. 


Usage Notes 


1. 


What Is a "userid NAMES" File? 


A “userid NAMES" file (where "userid" is your userid) is a 
collection of information about other computer users with whom you 
communicate. An “entry" in this file is all the information 
associated with a particular nickname. 


Having a "userid NAMES" file makes it easier for you to communicate 
with other users, because you can assign nicknames to them. You 
can then prepare notes for and send files and messages’ to other 
users by uSing their nicknames as operands in the NOTE, SENDFILE, 
and TELL commands. 


You can also create an entry for a list of nanes. In this case, 
the nickname refers to all the users in the list. This makes it 
possible to send notes, files, or messages to everyone on the list 
by issuing the appropriate command only once. 


Entering Information on the NAMES Menu 


The NAMES menu helps you to create and edit a "userid NAMES" file. 
All of the informaticn you type on one menu is an "entry" in the 
file. You fill in the fields on the menu and press a PF key to 
create, display, and/or change your names file. The PF key 
functions are described in the usage note, "PF Key Settings on the 
NAMES Menu". 


The following list describes the various fields on the’ menu and 
explains the information you type in. Refer to the sample menus in 
the "Examples" section, below, to see the location of the fields on 
the menu. 
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Nickname: 


is any name you choose to represent a Single user ora list of 
users. An example of each is shown in the "Examples" section, 
below. Once an entry is created, the nickname is the only piece of 
information you need to communicate with this user (using the NOTE, 
SENDFILE, or TELL commands). 


You should create an entry for yourself, because the fields that 
contain your mailing address, phone number, etc., are used by the 
NOTE command to generate headings. 


Userid: 


is the userid of the person whose nickname you specified. You can 
leave this field blank if the nickname represents a list, that is, 
if the List of Names field is filled in. However, if the nickname 
represents a list and you also specify a userid, the note is also 
sent to this userid. 


You can also leave this field blank if you want the entry to 
contain information about a person, but you do not intend to 
communicate with him via the computer. You might choose to do this 
if you're using the NAMES file simply to compile an address list. 


Node: 


is the node of the person whose nickname you specified. If not 
specified, the default node is the one on which this names file 
exists. You can leave this field blank if the nickname represents 
a list. 


Notebook: 
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is the filename of a file whose filetype is NOTEBOOK, in which 
notes (prepared by the NOTE command) sent to or received from this 
person are to be kept. You can leave this field blank if you want 
all incoming and outgoing notes saved in the default notebook file, 
AIL NOTEBOOK. 


Names 


is the name of the person whose nickname you specified. You can 
leave this field blank if the nickname represents a list. 


Phone: 


is the phone number(s) of the person whose nickname you specified. 
You can leave this field blank if the nickname represents a list. 


Address: 


is the address of the person whose nickname you specified. You can 
leave this field blank if the nickname represents a list. 


List of names: 


is the names of the people in a list, when the nickname represents 
the name of this list. The names of the people in the list can be 
specified in the following ways: as a nickname of an entry in the 
names file; as a userid of a user who shares your computer; or in 
the form "userid AT node". Each time you send a note, a file, or a 
message to the nickname specified, it will go to everyone on this 
list. A sample entry for a list of names is shown in the 
"Examples" section, Lelow. 
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3. PF Key Settings on the NAMES Menu 


The PF key functions appear on the NAMES menu itself 

"Examples") and are Summarized in the following list: 

PF 1 Help Display NAMES command description. 

PF 2 Add Add this entry to the NAMES file. 

PF 3 Quit Exit from menu. 

PF 4 Clear Clear input fields. 

PF 5 Find Locate in the file the first field that 
filled in on the menu. 

PF 6 Change Change this entry. 

PF 7 Previous Display the previous entry. 

PF 8 Next Display the next entry. 

PF 9 Not assigned. 

PF 10 Delete Delete this entry. 

PF 11 Not assigned. 

PF 12 Cursor Place cursor in Nickname field. 


NAMES 


(see 


is 


Note: On a terminal equipped with 24 PF keys, PF keys 13 to 24 are 


assigned the same values as PF keys 1 to 12 as discussed here. 


4. Updating a “userid NAMES" File 


You can make changes to the file by using the menu and appropriate 
PF keys (see above), or by editing the file (XEDIT userid NAMES). 
If you issue NAMES from a line mode terminal, you are placed in 


edit mode, editing the file “userid NAMES". The format of 


a 


"userid NAMES" file is shown in the "Examples" section of the 


NAMEFIND command. 
Responses 


"‘name' has been added to your userid NAMES file. 
Entry has been deleted from your userid NAMES file. 
Entry changed in your userid NAMES file. 

Warning: There {isj{are} nn undisplayed tag(s). 


The following response is displayed on a line node terminal: 
You are now editing your Userid NAMES File. 

Error Messages and Return Codes 

DMNSWNM649E EXTRANEOUS PARAMETER ‘value'. kRC=24 

Messages when in the NAMES panel: 


DMSWNM645W THE USER TAG NAME ‘tagname’' IS TOO LONG TO DISPLAY 
IN THE PANEL. 

DMSWNM656E ERROR SEARCHING YOUR NAMES FILE, 
RC = XX FROM NAMEFIND COMMAND. 

DMSWNM657E UNDEFINED PFkey. 

DMSWNM658W THE VALUE FORK THE 'tag* TAG IS TOO LONG TO DISPLAY 
IN THE PANEL. 

DMSWNM660E THE NICKNAME FIELD MUST BE FILLED IN. 

DMSWNM660W WARNING: THIS ENTRY DUPLICATES AN EXISTING NICKNAME. 

DMSWNM662E YOU ARE NOT CN AN ENTRY. PRESS PF 5, 7 or 8 
TO MOVE TO AN ENTRY. 

DMSWNM664E {Entry|Next entry|Previous entry} NOT FOUND. 
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Examples 
The following is an entry in the file "SNOWHITE NAMES". 


| NS aa Ra aa aaa a a TR a aaa aE | 
| ====> SNOWHITE NAMES <========> NAMES FILE EDITING <==== 
| 
{Fill in the fields and press a PFkey to display andyor change your NAMES file 
| 
|Nickname: SNOW Userid: SNOWHITE Node: FOREST Notebook: 
| Name: Snow White 
Phones: 222-2222 
Address: Forest Primeval 


List of Names 


You can enter optional information below. Describe it by giving it a “tag". 


_—e eee eee ee ee ee eee eee eee eee eee ee 


Tag: Values 

Tag: Value: 

1= Help 2= Add 3= Quit 7= Previous = Next 9= 

4= Clear 5= Find 6= Change 10= Delete 11= 12=Cursor | 
===> | 


ed ee ee 


MACRO-READ 1 FILE| 


Figure 21. Sample NAMES Screen 
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The following menu shows an entry for a list of names. Each name in the 
list is the nickname of an entry in the names file. 


| ====> SNOWHITE NAMES €========>> NASMNES FILE EDITING <==== 
l 
{Fill in the fields and press a PFkey to display and/or change your NAMES file 
l 
j|Nickname: DWARFS Userid: Node: Notebook: 
Name: 
Phone: 
Address: 


List of Names 


i 
| 
| 
l 
I 
l 
l 
l 
l 
{ 
t 
SNOOZY DUMMY BOSS SMILEY GROUCHY SNIFFLES WISTFUL| 
I 
{ 
l 
I 
[You can enter optional information below. Describe it by giving it a "tag". | 

( 

| 

| 

{ 

| 

| 


[| Tag: Value: 

|Tag: Value: 

| 

|1= Help 2= Add 3= Quit 7= Previous 8= Next 9= 

{4= Clear 5= Find 6= Change 10= Delete 11= 12=Cursor 
| ===> 

| 


| 
MACRO-READ 1 FILE| 


_————— SS ee ee 


Figure 22. Sample Entry for a List of names. 
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Use the NOT& EXEC procedure to prepare a "note" for one or more computer 
users on your computer or cn other computers connected to yours via the 
Remote Spooling Communications Subsystem (RSCS) network. A "note" is a 
short communication, the kind usually done by letter. Some of the 
features of the NOTE command are: 


e The System Product editor (XEDIT) controls the environment in which a 
note is prepared. Therefore, the full power of the editor is 
available to help you frepare notes. 


e NOTE is one of several commands that references a "userid NAMES" 
file. By setting up a names file, you can identify recipients just 
by using nicknames, which are automatically converted into node and 
userid. For informaticn on creating a names file, see the NAMES 
command. 


e Notes can be sent not only to individual users but also to everyone 
on a list. 


e Headings identifying the sender and the recipients are automatically 
generated on each note. The information in the headings is collected 
from the “userid NAMES" file. Notes can be prepared with either 
short or long headings. An example of each is shown in the 
"Examples" section, below. 


e PF keys are assigned to frequently used functions like sending the 
note, tabbing, calling for HELP, etc. 


The format of the NOTE command is: 


{[ name... [CCCs name...]] [ (options...[) ]] 


l 

| 

| options; 
| [ACk] NOAck] 

[| [aDd] 

I [ Cancel ] 

| [ NOTebook fn|NOTebook *| NONotebook ] 
| [ LOG |NOLog ] 

|  [LONg| Short] 

| [ Replace ] 

| [ PROFile fn] 


nane is one or nore "names" of the computer users to whom the note is 
to be sent. If the same recipient is specified more than once, 
he receives only one copy of the note. The "name" may take any 
of the following forms, and the different forms can be freely 
intermixed: 


e a"nicknane" that can be found in the file “userid NAMES", 
where "userid" is your userid. This nickname may represent a 
Single person (on your computer or on another computer), or a 
list of several people. 


e aouserid of a user on your computer. If a name cannot be 
found in the "userid NAMES" file, it is assumed to be a 
userid of a user on your computer. 


e "userid AT node", which identifies a user ("userid") on your 
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computer or ancther computer ("node"). 


A userid cannot be "AT" or "CCCs", 


CC: indicates the following name(s) are “complimentary copy" 
recipients of the note. A name can take any of the forms 
described above. Complimentary copy recipients are designated 
as such in the note header. 


Issued without 


parameters, NOTE is used to continue a note that was 


started previously. For more information on saving and continuing 
notes, see the usage note, "Continuing Notes". 


Options: 


ACk 


NOAck 


ADd 


Cancel 


NOTebook fa 


NOTebook * 


requests an acknowledgment be sent to you when _ the 
addressee receives your note. For nore information on 
acknowledgments, see the RECEIVE command description. 


requests that no acknowledgment be sent. 


causes the addressees to be added to the current 
invocation of NOTE. No other options may be specified 
when the ADD option is used. This option is intended to 
be used from within the NOTE command environment. For 
more information on this option, see the usage note, 
"Adding and Deleting Names of Recipients", 


causes the note you are currently editing to be erased. 
You are returned to the file you were previously editing 
or to CMS, and no note is sent. You enter NOTE with the 
CANCEL option from the XEDIT command line. All other 
options are ignored if CANCEL is specified. 


causes the text of the outgoing note to be saved ina 
file named "fn NCTEBOOK". You can use this option if you 
want a copy of the note(s) sent to a particular recipient 
to be kept in a separate file. 


If you do not specify a notebook filename here, a 
filename is first searched for in the (first) recipient's 
entry in your "userid NAMES" file, and then in a file set 
up by the DEFAULTS command. If neither contains a 
notebook filename, the note is saved in the default 
notebook file, “ALL NOTEBOOK". A note is saved by 
appending it to the NOTEBOOK file, with a line of 73 
equal signs (=) separating each note. 


(See the NAMEFIND or NAMES command for nore information 
on the relationship between the NAMES file and the 
NOTEBOOK file.) 


specifies that the text of the outgoing note is saved in 
a file named "name NOTEBOOK", where "name" is the value 
of the Notebook tag in the recipient's entry in your 
“userid NAMES" file, or the recipient's nickname, or the 
recipient's userid (whichever is located first). 


When there is more than one recipient, the full text of 
the note is saved in the NOTEBOOK file of the first 
addressee (selected as described above). In the notebook 
files of the other addressees and complimentary copy 
recipients (if any), only the note header anda line 
referencing the file in which the full text exists is 
saved. The search order for the notebook filename for 
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these recirfients is the same as described above. 


NONotebook Specifies that a cory of the outgoing note is not to be 
saved. 
LOG specifies that the addressees, date, and time of this 


note are logged ina file called “userid NETLOG", where 
"userid" is your userid. This log is updated when 
acknowledgments are received (if they were requested). 


NOLog specifies that this note is not to be logged. 

LONg causes the lcng form of the note header to be used. An 
example of the long form is shown in the "Examples" 
section, below. 

Short causes the short form of the note header to be used. An 
example of the short form is shown in the “Examples" 
section, below. 

Replace causes the work file from a previously interrupted note 
to be erased before NOTE is entered. If there is no work 
file, this option has no effect. 

PROFile fn specifies the name of an XEDIT macro to be executed when 


XEDIT is invoked by the NOTE command. By default the 
macro PRCFNOTE XEDIT is invoked. For nore information on 
the PROFNOTE macro, see the usage note, "Default PF Key 
Settings". 


Usage Notes: 


We 
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Tailoring the NOTE Command Options 


You can use the DEFAULTS command to set up options and/or override 
command defaults for NOTE. However, the options you specify in the 
command line when entering’ the NOTE command override those 
specified in the DEFAULTS command. This allows you to customize 
the defaults of the NOTE command, yet override them when you 
desire. Refer to the DEFAULTS command description for more 
information. 


The current options for an invocation of the NOTE command are 
displayed as the second line of the file while the note is being 
prepared. You can alter some of these options (such as LOG or ACK, 
but not LONG or SHORT) by typing over this line. The options line 
is not sent with the note. 


Composing the Note 


When you enter the NCTE command, the note screen appears (with the 
headings). An example of a note screen iS Shown in the "Examples" 


section, below. You type in the text of your note in the XEDIT 
environment. The full power of XEDIT is available while you 
compose your note. Initially, you are placed in edit mode 
(although no prefix area or scale is displayed). You can also 


enter input or power typing mode by entering the appropriate XEDIT 
subcommand. 


The PROFNOTE macro is executed when you issue the NOTE command. It 
assigns values to PF keys and creates two synonyms that make the 
NOTE command easier to use. The synonyms are SEND and CANCEL, for 
"SENDFILE (NOTE" and "NOTE (CANCEL", respectively. SEND is also 
assigned to a PF key. (You can specify the name of a different 
macro in the PROFILE option if you do not want the PROFNOTE macro 
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to be executed.) 

Sending the Note 

To send the note, you can do one of the following: 
e Press the PF5 key. 


e Enter SENDFILE (NOTE or SENDFILE (NOTE OLD. The OLD option 
should be used when the recipient does not have the RECEIVE 
command available to read the note. For more information on the 
OLD option, see the SENDFILE command. 


e Enter SEND (a synonym for “"SENLFILE (NOTE"). 


The note is sent to the addressees and is logged or saved as 
specified. Control is returned either to CMS or to the file that 
was being edited when NOTE was issued. 


Continuing Notes 


If you want to save a note and finish it later, issue the XEDIT 
Subcommand FILE from the command line. No note is sent, but the 
note is kept on your disk as "userid NOTE AO". To continue the 
note later, issue the NCTE command with no parameters. 


Adding and Deleting Names of Recipients 


You can add recipients to a note while composing it, that is, after 
you have already entered a NOTE command. To do this, issue a NOTE 
command with the ADI option (from the xXEDIT command line), 
Specifying the names of the additional recipient(s). For example, 


===> NOTE namel name2 (ADD 


Any nicknames are resolved, and the additional recipients are 
automatically added to the note header. 


You can also alter the address list and complimentary copy list by 
typing over the header lines. However, with this method, no 
hicknames are resolved, and no userids are checked for validity. 
Therefore, issuing the NOTE command with the ADD option is’ the 
preferred way to add recipients. 


You can delete the names of recipients directly from the note 
screen. Just blank out the names you wish deleted from the header 
lines. 

Naming Conventions for Userid and Node 

You cannot send a necte to a userid (or nickname) or node named AT 
or CC:, nor cah your userid be AT or CCCs. Also, your userid must 
contain only those characters that are valid for CMS filenames. 


Conflicting Options 


If conflicting options are entered (such aS ACK and NOACK) the last 
one entered (the rightmost) overrides the others. 
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Default PF Key Settings 


The PROFNOTE XEDIT macro is executed when the NOTE command is 
invoked. It sets the PF keys to the following functions: 


PF 1 Help Display NOTE command description. 

PF 2 Add Add a blank line after the line containing 
the cursor. 

PF 3 Quit Quit this note. The following message nay be 


displayed: FILE HAS BEEN CHANGED. USE QQUIT 
TC QUIT ANYWAY. 


PF 4 Tab Tak the cursor. 

PF 5 Send Issue SENDFILE with the NOTE option. 
PF 6 rs Display the last command issued. 

PF 7 Backward Scroll back one screen. 

PF 8 Forward Scroll forward one screen. 

PF 9 = Repeat the last command issued. 

PF 10 Split Split the line in two, at the cursor. 
PF 11 Join Join two lines, at the cursor. 


PF 12 Powerinput Enter power typing mode (XEDIT subcommand 
POWERINP). 


Note: On a terminal equipped with 24 PF keys, PF keys 13 to 24 are 
assigned the same values as PF keys 1 to 12 as discussed here. 

If you enter the "PROFILE fn" option, the macro specified (fn 
XEDIT) is invoked instead of PROFNOTE XEDIT. In "fn XEDIT", you can 
easily change the PF key settings. 

The format of the file created by NOTE and sent by the SENDFILE 
command is described in the SENDFILE command description, in the 
section "Format of the File Sent by SENDFILE". 

You cannot start a new note while in NOTE. 

Format of the Note Header Records 

Header records are generated automatically in the note file. The 
information in the headers is collected from the defaults and 
options you supplied in the NOTE command. 

You can change the information displayed on these lines simply by 
typing over them. Changing the recipients (the users listed in the 
"To:" line) is discussed in the usage note, "Adding and Deleting 
Names of Recipients". 

You can also type over the NOTE command options (the "OPTIONS":" 
line). Because the information listed in these lines is 
positional, you must type over the options in the correct order. 
The format of the options header record is as follows: 

OPTIONS: opt1 opt2 opt3 opt4 optd 

where: 

opti is either ACK or NOACK. 

opt2 is LOG or NOLOG. 

opt3 is LONG or SHORT. (This option cannot be altered.) 


opt4 is NOTEBOOK or NONOTEBOOK. 
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opt5 is the NOTEBOOK filename: ALL, *, or the filename specified 
in the NOTE command. 


The other header records are: 
Date: is the date and time the note is prepared. 


From: is information about the sender. The format of this line 
depends on whether LONG or SHORT is specified. 


To: is information about the recipient(s). The format of this line 
depends on whether LONG or SHORT is specified. 


cc: is information about the complimentary copy recipient(s). The 
format of this line depends on whether LONG or SHORT is 
specified. 


Responses 


Note cancelled. 


Error Messages and Return Codes 


DMSWNTOO3E INVALID OPTION ‘option'. RC=24 
DMSWNTOO6GE NO READ/WRITE DISK ACCESSED. RC=36 
DMSSTTO62E INVALID CHARACTER ‘character! IN FILEID 'fn ft'. RC=20 
DMSWNT637E MISSING {value|'value"} FOR THE {'option' OPTION| 
"operand* OPERAND}. RC=24 
DMSWNT647E USERID NOT SPECIFIED FOR ‘nickname! IN '‘Userid 
NAMES* FILE. RC=32 
DMSWNT648E USERID ‘name NOT FOUND. CHECK THE '‘Userid NAMES" FILE. 
RC=32 
DMSWNT651E {*CANCEL'|*ADD"} MUST BE ISSUED FROM NOTE. RC=40 
DMSWNT665E FILE ‘Userid NCTE ** NOT FOUND. TO BEGIN A NEW NOTE 
ENTER "NOTE name". RC=28 
DMSWNT666E NOTE ALREADY EXISTS. ENTER "NOTE TO CONTINUE 
OR SPECIFY "REPLACE'. RC=28 
DMSWNT668E THE "ADD* OPTION MUST BE SPECIFIED ALONE. RC=40 
DMSWNT669E LIST OF ADDRESSEES CANNOT BEGIN WITH 'CCs* RC=24 
DMSWNT670E NO NAMES TO EE ADLDED WERE FOUND. RC=24 


Messages when in the NOTE environment (in XEDIT): 


DMSWNT667E NOTE HEADER DOES NOT CONTAIN THE {keyword 
"FROM*| keyword "TOs "|"OPTIONS" LINE}. 


Examples 


When a NOTE command is issued, the type of heading generated depends on 
whether the SHORT option (the default) or LONG is specified. The short 
form lists only the userids and nodes (if different from the sender's) 
of the addressees. The long form also lists the name and phone number 
of each addressee. 


An example of each type of heading is shown below. The information in 
the headings was collected from the names file shown in the "Examples" 
section of the NAMEFIND command. 


The command “NOTE DWARFS CC: GORGEOUS", where DWARFS and GORGEOUS are 


nicknames in the names file referenced above, produced the following 
screen: 
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—_— 
SNOWHITE NOTE AO F 80 TRUNC=80 SIZE=24 LINE=12 COLUMN=1 


| 
| 
| 
{OPTIONS: NOACK LOG SHORT NOTEBOOK ALL 

| 

{Date: 11 February 1981, 11:04:52 EDT 

|From: Snow White Z22~ 2222 SNOWHITE at FOREST 

| To: SNOOZY at COTTAGE, DUMMY at COTTAGE, BOSS at COTTAGE, SMILEY at COTTAGE 
| GROUCHY at COTTAGE, SNIFFLES at COTTAGE, WISTFUL at COTTAGE 

[ccs PRINCE at ATLARGE 

| 

|Dear Guys, 

| Would you be interested in hiring domestic help? 

|I understand the cottage is a mess, what with your having 

|to work in the mines and sing "Heigh-Ho" and all that. 

[In addition to being a hard worker, my skin is white as snow, 

|my lips are red as blood, and I have black hair. 


Ce I a ee 


| Sincerely, 

| S. White 

| 

| 1=Help 2=Add line 3=Quit 7=Backward 8=Forward == 

|4=Tab 5=Send 6=? 10=Split 11=Join 12=Powerinput | 
| ===> | 
| X EDIT 1 FILE 
ee ee er eT eo a ee Se ee Ne ce ee ee nee 


Figure 23. Sample Note with Short Headings 


If the command "NOTE DWARFS CC: GORGEOUS (LONG" is issued, the headings 
look like this: 


c—_— 
J|OPTIONS: NOACK LOG LONG NOTEBOOK ALL 


| 
|Date: 11 February 1981, 11:04:52 EDT 


|From: Snow White ZZ2Z-Z2Z22 SNOWHITE at FOREST 
| Forest Primeval 

|To: I. M. Dozing 777-7777 SNOOZY at COTTAGE 
| S. A. What 777-7777 DUMMY at COTTAGE 
| T.O.P. Banana 777-7777 BOSS at COTTAGE 
| H. A. Haas 771-7777 SMILEY at COTTAGE 
| E. B. Scrooge 777-7777 GROUCHY at COTTAGE 
| A. H. Choo 777-7777 SNIFFLES at COTTAGE 
| R. U. Shy 777-7777 WISTFUL at COTTAGE 
| 


cc: Prince Charming 111 111-1111 PRINCE at ATLARGE 
ee a re ee aN 


Figure 24. Example of Long Headings 
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NUCXDROP 


Use the NUCXDROP command to cancel nucleus extensions and release the 
storage occupied by the corresponding progran. The NUCXDROP command 
uses the NOUCEXT function which is described in detail in the section of 
this book devoted to functions. 


The command format is: 


|NUCXDROP | { name 1 [ name2... i | 

| | * 4 
Where: 

na ne Is the nucleus extension to be cancelled. 

* Means all currently loaded nucleus extensions. 


Usage Notes 


1. If a nucleus extension has the 'SERVICE' attribute, it is called by 
NUCXDROP with the follcwing parameter list: 


DS OF 

DC CL8* NUCLEUS EXTENSION NAME! 
DC CL8" RESET! 

DC 8X" FF* 


The high order byte in register 1 is set to X'FF*. 


2. It is the responsibility of the unloaded program to cancel any 
secondary aucleus extension entry points by reacting to the RESET 
service call issued by NUCXDROP before the main entry point is 
cancelled and the program unloaded. The RESET call allows programs 
with several entry points to cancel these at the same time, or to 
free static storage areas obtained from free storage. 


3. Look-aside entries can not be dropped. Look-aside entries are 
described in Section 6 of this manual under NUCEXT function. 


eturn Codes 


DMSNXDO50E PARAMETER MISSING AFTER NUCXDROP RC=24 

DMSNXDO7VOE INVALID ARGUMENT ‘argument RC=24 

DMSNXD616W ‘name* DOES NCT EXIST RC=28 

DMSNXD617E ERROR CODE n FROM DMSFRET WHILE UNLOADING 
"module name* MCLDULE RC=3 

DMSNXD624W NO NUCLEUS EXTENSIONS ARE LOADED RC=28 
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NUCXLOAD 


Use NUCXLOAD to install nucleus extensions. The command loads either an 
ADCON-free, serially reusable, or relocatable module into free storage 
and installs it as a nucleus extension. The nucleus extension is 
invoked by issuing the name of the nucleus extension. The NUCXLOAD 
command uses the NUCEXT function which is described in detail in the 
section of this book devoted to functions. 


The format of the command is: 


ht OOO OO OO ee nny 
[NUCXLOAD | hnane [ fa j J [({ S¥stem] [SErvice] [Push] [) J]l 
| l Vase nember aanane } | 
i a a i a os ee eee 


Where: 


name fn 

"‘name' is the name associated with this nucleus extension. 
'fn' is the optional filename of a module file to be loaded 
and associated with ‘name'. The module being loaded must be 
either an ADCON-free or serially reusable module. The tern 
ADCON-free implies that the program needs no reiocation, 
i-e., it runs correctly when loaded at an address different 
from that at which it was generated (via GENMOD). It allows 
the object module to be read directly into storage obtained 
from the free storage manager, after determining the size 
needed from the module header {or the file format, for the 
one-record fixed format CMS system transient routines). The 
term serially reusable implies that the same copy of a 
routine may be used by another task after the current use 
has been concluded. If the second argument (i.e., fn) is 
not specified, the command name is also used as the filenane 
of the module. 


hame member ddnane 
'‘namet is the name to be associated with this nucleus 
extension. ‘member' must be a member of a CMS or OS load 
library. To create a CMS load likrary, see the CMS command 
LKED. ‘ddnamet is the ddname from the FILEDEF conmand that 
must be issued prior to calling the NUCXLOAD that identifies 
the load library. 


SYstenm indicates that system free storage should be used, and the 
program is to receive control disabled, key 0O. The SYSTEM 
option is assumed by default for transient routines 
generated with the SYSTEM option of the GENMOD command. 


SErvice indicates that service calls are accepted (for instance a 
PURGE from an abend). 


Push causes no check to be made to see if there is already a 


nhucleus extension of the same name. Otherwise, an existing 
nucleus extension is not overridden. 
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| Usage Notes: 


1. Nucleus extensions remain in effect until cancelled, either 
explicitly or implicitly. Implicit cancellation normally occurs 
only for nucleus extensions of the ‘user' type (during an abnormal 
end cleanup time when all stcrage of ‘user' type is reclaimed). 
Explicit cancellation does not release the storage (if any) 
occupied by the nucleus extension: that is the responsibility of 
the program that issues the cancellation (usually the progran 
NUCXDROP). 

2. Overlay modules may not be loaded by NUCXLOAD. 

3. GETMAIN storage management should generally not be used by modules 
loaded as nucleus extensicns, unless all such storage is released 
before returning from the nucleus extension and no command is 
issued from the nucleus extension which may perform a STRINIT 
function. 

4. If a module generated from a higher level language is loaded using 
NUCXLOAD, caution should be taken when passing parameters’ to the 
module. See the registers on entry to a nucleus extension in 
Section 6 of this manual under NUCEXT function. 

Responses 
None. 


Messages and Return Codes 


DMSNX 
DMSNX 
DMSNX 
DMSNX 
DMSNX 
DMSNX 
CDMSNX 


Retur 


1 


4 


12 


LOO1E NO FILENAME SPECIFIED RC=24 

LO7VOE INVALID ARGUMENT ‘argument* RC=24 

L104S ERROR ‘'n* READING FILE ‘fn £t fm* FROM DISK RC=100 
L589E MISSING FILFDEF FOR DDNAME ‘ddname* RC=32 

L618E NUCEXT FAILED RC=13 

L619E MODULE ‘module name NOT FOUND RC=28 

L622E INSUFFICIENT FREF STORAGE RC=41 


Codes 


Nucleus Extension already exists. 


Module is marked "not executable." The module is not 
loaded; no nucleus extension is defined. To determine 
why the "not executable" flag was set, examine the 
information provided by the linkage editor at the 
time the module was created. 


Module is an overlay structure. The module is not 
loaded; no nucleus extension is defined. Overlay 
structures may not be used as nucleus extensions, 
because CMS does not support more than one such 

program at a time. Only an overlay structure in 

the user area is supported. If this program is to 

be used as a nucleus extension, it must be restructured 
so that it does not require overlays. 


Module is marked ‘only loadable." ‘The module is not 
loaded; no nucleus extension is defined. Modules are 
marked “only loadable" kecause of an explicit command 
to do so at the time they are link-edited. This is 
typically done when a module contains data, but not 
executable instructions. Such a nature makes a module 
unsuitable for use aS a nucleus extension. 


Section 2. CMS Commands 235 


NUCXLOAD 


13 


24 


28 


32 


47 


100 


The nucleus extension could not be installed. 


A filename was not specified, an invalid operand was : 
specified, or too many or extraneous operands were ) 
specified. 


This is the return code generated by NUCXLOAD when the 
specified module cannot be found. It is also used in 
the case of an error when ofening a LOADLIB file, in 
which case message DMSSOPO36E is produced by the open 
routine. 


For NUCXLOAD, a FILEDEF command identifying the load 
library must be issued prior to calling NUCXLOAD. 


There was not enough free storage to build the table of 
SCBLOCK addresses. 


An unrecoverable error occurred while reading the module 
from disk. 
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NUCXMAP 


Use the NUCXMAP command to get information about the currently defined 
nucleus extensions. NUCXMAP displays on the console or stacks a list of 
the nucleus extensions. The NUCXMAP command uses the NUCEXT function 
which is described in detail in the section of this book devoted to 
functions. 


The command format is: 


| r 1 | 
|NUCXMAP | CALL] [([STACK] |LIFO| [)]] 
| l {FIFO| { 
| t J | 
a a a ea ge 


Wheres: 


If no options are specified, one line describing each 
loaded nucleus extension is printed on the user's 
virtual console. 


ALL Produces a descriptive line for NUCEXT look-aside 
entries as well as nucleus extensions. Look-aside 
entries are described in Section 6 of this nmanual 
under NUCEXT function. 


STACK LIFO Specifies that the information should be placed in 
FIFO the program stack (for use by an EXEC or other 
program) instead of being displayed at the terminal. 
The information is stacked either FIFO (first in 
first out) or LIFO (last in first out). The default 
order is FIFO. ‘The header is not stacked. 


FIFO Specifies that the information should be placed in 
the program stack rather than displayed at the 
terminal. The information is stacked FIFO. The 
options STACK, STACK FIFO, and FIFO are all 
equivalent. The header is not stacked. 


LIFO Specifies that the information should be placed in 
the program stack rather than displayed at _ the 
terminal. The information is stacked LIFO. This 
option is eguivalent to STACK LIFO. The header is 
not stacked. 
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Responses 


NAME 


GLOBALV 


EXECIO 


NAMEFIND 
IDENTIFY 


ENTRY 

0E9888 
1F4cCco 
1F7020 
OE5SEYS 


USERWORD 
00000000 
OOOADE70 
0OO00AAE70 
00000000 


Messages and Return Codes 


DMSNXMO7OE 
DMSNXM622E 
DMSNXM624T 


ORIGIN 
0E9888 
1F4CCO 
1F7020 
OE5E&S 


BYTES 

001258 
000000 
000000 
0001C8 


INVALID PARAMETER ' parameter' 


NO NUCLEUS EXTENSIONS 


(ALL NUMBERS ARE HEXADECIMAL) 
SYSTEM SERVICE 
SYSTEM SERVICE 
SYSTEM SERVICE 


RC=24 
INSUFFICIENT FREE STORAGE (nn ENTRIES) 
ARE LOADED RC=0 


RC=41 
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OPTION 


Use the OPTION command to change any or all of the options in effect for 
the DOS/VS COBOL compiler and the RPG II compiler in CMS/DOS. The 
format of the OPTION ccmmand is: 


ag ee ee 


| OPTION | [options... ] | 
l A | 
d i options: 4 
! | cr 1 =f 1 ~«O¢ 1 ~«OF 1 Of 1 ( 
{ { JDUMP | {DECK [| |JLIST | |JLISTX | [SYM | | 
| i | NODUME | JNODECK] {| NOLIST| | NOLISTX] {NOS YM] | 
| | L 3 oot 3 ot 3 ok a <b 4 i 
l i c 1 «OF 1 1 ~«O¢ 1 l 
| | {| XREF | {ERRS | {48C| | TERM | | 
{ | | NOXREF | {NOERRS|] | 60C] | NOTERM | | 
I L s ot a ot 3k 4 


Nr rrr eam a St si ee as ane mm msi meet mc i nS ati mn om i a a eel 


Options: If an invalid option is specified on the command line, an 
error message is issued for that option; all other valid options are 
accepted. Only those options specified are altered, and all other 
options remain unchanged. 


DUMP dumps the registers and the virtual partition on the virtual 
SYSLST device in the case of abnormal program end. 


NODUMP suppresses the DUMP option. 

DECK punches the resulting okject module on the virtual SYSPCH 
device. If you do not issue an ASSGN command for the logical 
unit SYSPCH before invoking the compiler, the text deck is 
written to your CMS A-disk. 

NODECK suppresses the LECK cption. 


LIST writes the output listing of the source module on the SYSLST 
device. 


NOLIST suppresses the LIST option. This option overrides the XREF 
option as it does in DOS/VS. 


LISTX produces a procedure division map on the SYSLST device. 
NOLISTX suppresses the LISTX option. 
SYM prints a Data Division maf on SYSLST. 


NOSYM Suppresses the SYM oftion. 


XREF writes the output symbolic cross-reference list on SYSLST. 
NOXREF suppresses the XREF option. 


ERRS writes an output listing of all errors in the source progran 
on SYSLST. 


NOERRS suppresses the ERRS option. 


48sc Uses the 48-character set. 
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60 Uses the 60-character set. 


TERM Writes all compiler messages to the user's terminal. 


NOTERM Suppresses the TERM option. 


Usage Notes 


1. If you enter the OPTION command with no options, all options are 
reset to their default values, that is, the default settings that 
are in effect when you enter the CMS/DOS environment. CMS/DOS 
defaults are not necessarily the same as the defaults generated on 
the VSE system being used and do not include additional options 
that are available with some DOS compilers. 


2. The OPTION command has no effect on the DOS PL/I compiler nor on 
any of the OS language compilers in CMS. 
Responses 


None. To display a list of options currently in effect, use the QUERY 
command with the OPTION operand. 


Error Messages and Return Codes 


DMSOPTO7OE INVALID PARAMETER ‘parameter RC=24 
DMSOPTOS9E CMS/DOS ENVIRONMENT NOT ACTIVE RkC=40 
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OSRUN 


Use the OSRUN command to execute a load module from a CMS LOADLIB or an 
OS module library. The library containing the module must have been 
previously identified by a GLOBAL command. For an OS module library, 
the library must also have been defined in a FILEDEF command. If no 
library has been identified by a GLOBAL command, the OSRUN command 
searches the $SYSLIB LOADLIB library for the specified module. The 
format of the OSRUN command is: 


SS ee ee ee 
| OSRUN | member [ PARM=parameters ] | 


where: 

member is the member of a CMS LCADLIB or an OS’7 module library to be 
executed. 

PARM= are the OS parameters that the user wants to pass to the 
module. If the parameters contain t-lanks or special 
characters, they must be enclosed in guotes. To include 
quotes in the parameters, use double quotes. The parameters 


are passed in OS format: register1 points to a fullword 
containing the address of a character string headed by a 
halfword field containing the length of the character string. 
The parameters are restricted to a maximum length of 100 
characters. 


Note: You may not pass parameters (PARM=) to the module if you 
issue the OSRUN command from a CMS EXEC file. The OSRUN 
command can be issued from an EXEC 2 file with no 
restrictions. 


Messages and Return Codes: 


DMSOSROO1E NO FILENAME SPECIFIED RC=24 

DMSLOSO13E MEMBER member name NOT FOUND IN LIBRARY RC=32 
DMSOSRO52E MORE THAN 100 CHARACTERS OF OPTIONS SPECIFIED RC=24 
DMSOSRO7VOE INVALID PARAMETER RC=24 

DMSLOSO73E UNABLE TO OPEN FILE *fn* RkC=28 
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PEEK 


PEEK 


Use the PEEK EXEC procedure to display a file that is in your virtual 
reader without reading it onto your disk. Once you issue the PEEK 
command you can use KXEDIT subcommands to view the file. In most cases 
the files in your reader were sent to you by other computer users, on 
your computer or on other computers that are connected to yours via the 
Remote Spooling Communications Subsystem (RSCS) network. 


The format of the PEEK command is: 


{spoolid] [ (options... [) }] 


| | 
| | 
{| options: l 
| [FRom recno] | 
{ {FOr numrec ] | 
; [ PROFile fn] | 


spoolid is the spoolid of the file to be displayed. The default is 
the "next" file in the virtual reader. 


The "next" file is the one for which the RDR command returns 
information. Which file this is depends on the class of the 
reader, the class of the files in the reader, and whether or 
not they are held. 


Options: 

FRom recno is the starting record number to be read. The default is 
1 (one). 

FOr numrec is the numker cf records of the file to be read. 
Specifying an asterisk (*) causes the entire file to be 
used. The default is to read up to 200 records. 

PROFile fn specifies the name of an XEDIT macro to be executed when 


XEDIT is invoked by the PEEK command. The default macro 
is PROFPEEK XEDIT. For more information on the PROFPEEK 
macro, see the usage note, "PF Key Settings on the PEEK 
Screen", 


Usage Notes: 
1. Tailoring the PEEK Command Options 


You can use the DEFAULTS command to set up options and/or override 
command defaults for PEEK. However, the options you specify in the 
command line when entering the PEEK command override those 
specified in the DEFAULTS command. This allows you to customize 
the defaults of the PEEK command, yet override them when you 
desire. Refer to the DEFAULTS command description for nore 
information. 


2. Editing from the PEEK Screen 


When you invoke the PEEK command you are placed inthe XEDIT 
environment, editing the file "spoolid PEEK Ai". The full power of 
XEDIT is available to you while you "peek" at the file. You can 
make changes to this file and then issue the XEDIT subcommand FILE 
or SAVE from the XEDIT command line on the PEEK screen. In this 
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PEEK 


case, the reader spool file is not changed. The changes are made 
only to the file that is saved or filed. 


You can purge the file by entering the DISCARD command from the 
XEDIT command line. The DISCARD command is described in _ the 
section "Special Command", below. 


PF Key Settings on the PEEK Screen 
The PROFPEEK macro is executed when the PEEK command is invoked, 


unless you specified a different macro aS an option in the PEEK 
command. It assigns the following values to the PF keys: 


PF 1 Help Display PEEK command description. 

PF 2 Add line Add a blank line after the current line. 

PF 3 Quit Exit from the PEEK display. 

PF 4 Tab Tak the cursor. 

PF 5 Clocate Locate the string specified in an XEDIT 
subcommand CLOCATE or CHANGE that is typed 
in the command line. This PF key is set to 
the XEDIT macro SCHANGE 6. For more information 
on its use, see the publication 
NMZSP System Product Editor Command and Macro 
Reference. 

PF 6 ?7/Change Display the last command, or change the string 
Specified in a CHANGE subconmmand. 
(The Change function is the XEDIT SCHANGE macro 
and must be used in conjunction with PF5.) 

PF Backward Scroll backward one screen. 


7 
PF 8 Forward Scroll £ferward one screen. 
9 


PF Receive Write this file on the A-disk, using the 
same filename and filetype. 
PF 10 Split Split a line in two, at the cursor. 
PF 11 Join Join two lines, at the cursor. 
PF 12 Cursor Place the cursor in the current column of the 


current line. 


Note: On a terminal equipped with 24 PF keys, PF keys 13 to 24 are 
assigned the same values as PF keys 1 to 12 as discussed here. 


If you enter the "PROFILE fn" option, the file "fn XEDIT" is 
invoked instead of the file PROFPEEK XEDIT. In "fn XEDIT", you can 
easily change the PF key settings. 


Files in DISK DUMP or NETDATA Format 


Files in DISK DUMP or NETDATA format are reformatted so that they 
are readable. However, the entire file must be "peeked" at and 
have a logical record length of less than 256 in order to be 
reformatted. For more information on NETDATA format, see the 
SENDFILE command. 


Using the PEEK Command 


This command is useful not only when issued in the CMS environment 
but also in the RDRLIST command environment. In the RDRLIST 
display, the PF11 key is set to the PEEK command. 


Special NETDATA Files from MVS with TSO Extensions (PP) 


The MVS with TSC Extensions program product (program number 
5662-285) can send an empty file. It can also send two files in 
NETDATA format in a single transmission. Peeking at an empty 
(null) file results in a warning message that the file is empty. 
Peeking at two files sent in one transmission results in two 
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ame eee ae ee eee eee ee ee ee eee ee ee eee Ee eee 


os eww ae See so ee ee ee 


PEFK 


messages, identifying each of the files. A line of equal signs (=) 
separates the two files. 


Responses: 
File|Note "fname ftype" frcem ‘user* at ‘node'. Format is 'transmission 
format’. 


Error Messages and Return Codes 


DMSWPKOO3E INVALID OPTION ‘option’. kRC=24 
DMSWPKO29E INVALID PARAMETER ‘parm* IN THE OPTION ‘option! FIELD. RC=24 
DMSWPK132S FILE IS TOO LARGE. RC=88 
DMSWPK156E FROM ‘nnn NCT FCUND - THE FILE HAS ONLY ‘nnon't 
RECORDS. RC=32 
DMSWPK630S ERROR ACCESSING SEOOI FIIE. RC=36 
DMSWPK637E MISSING VALUE FOR THE {PROFILE|FROM| FOR} CPTION. RC=24 
DMSWPK643E NO CLASS ‘class FILES IN YCUR BEADER. RC=28 
DMSWPK644E ALL READER FILFS ARE IN HOLD STATUS CR NOT CLASS 
"'class'. RC=28 
DMSWPK649E EXTRANEOUS PARAMETER ‘value’. RC=24 
DMSWPK650E INVALID SPOILID ‘nnnn'*. RC=20 
DMSWPK655E SPOOLID ‘nnnn' COFS NOT EXIST. RC=28 
DMSWPK672E VIRTUAL READER INVALIC CR NOT DEFINED. RC=36 
DMSWPK674E READER IS NCT READY. RC=36 
DMSWPK683E THE ENTIRE FILE MUST BE PEEKED TO BE REFORMATTED. RC=36 
DMSWPK684E FILE CONTAINS INVALIDC RECORDS AND CANNOT EE 
REFORMATTED. RC=36 
DMSWPK685E THE FILE IS TOC LARGE TO BE REFCRMATTED. RC=36 
DMSWPK686E THE FILE HAS AN LRECL GREATER THAN 255 
AND CANNOT EE REFCRMATTELT. RC=36 
DMSSTTO62E INVALID CHARACTER ‘character IN FILEID ‘fn ft fm'. 
RC=20 


Special Command Used in the PEEK Environment 


— ae —_ —_— — Pe ee we EED ae 


Use the DISCARD command tc purge the file displayed on the PEEK screen. 
DISCARD can be used cnly in the PEEK, FILELIST, and RDRLIST&T 
environments. When DISCAR[T is used to purge a file, an acknowledgment 
is sent to the sender (if requested). For more information on 
acknowledgments, see the RECEIVE colmand, the usage note, 
"Acknowledgments". You enter DISCARI in the XEDIT command line at the 
bottom of the PEEK screen. The spoolid of this reader file is 
automatically appended to the DISCARD command and it is displayed on the 
top line of the PEEK screen, as the filename of the PEEK file. 


The format of the DISCARD command as used in the PEEK environment is: 


Ee eae PO ee ee eT Ee ee ee gO ee Ee OL ee Se Re eg et ere ee al 
{DISCARD | | 
{ Ar Se a Nr a a ee Pe | 


Error Messages and Return Codes for DISCARD 


DMSWDC649E EXTRANEOUS PARAMETER ‘parameter'. RC=24 
DMSWDC651E DISCARD MUST BE ISSUED FROM RDRLIST, PEEK OR FILELIST. RC=40 
DMSWDC653E ERROR EXECUTING ‘command', RC = nnw RC=40 
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Examples 


A sample PEEK screen follows: 


File NEW IDEA from OHARA at BLUESRY. 
* * * TOP OF FILE * * * 
Small business Opportunity 


l 
| 
; 
| 
l 
| 
| 
| 
|Greetings... 
| 

| 


[computer microforms and integrated circuits. 


[it Bok's Fiche and Chips. 


=a 


| Bok 
| 

| 

| 

| 

| 

|1= Help 2= Add line 3= Quit 
}4= Tab 5= Clocate 6= ?/Change 
|===> 

| 

Rs a eee eae 


Figure 25. Sample PEEK Screen 


I am planning to ofen a store, in which I will sell 
I plan to call 


7= Backward 8= Forward 9= 


PEEK 


— 
3001 PEEK A1 V 255 TRUNC=255 SIZE=20 LINE=0 COLUMN=1 


Format is DISK-DUMP. 


10= Split 11= Join 12= Cursor 
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X EDIT 1 FILE 
eer | 
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PRINT 


PRINT 


Use the PRINT command to print a CMS file on the spooled virtual 
printer. The format of the PRINT command is: 


2 
| 


Lt 


PRint 


fn ft lfm [ (options...[) J] 
|* 


7 r 
HEADer] | | TRC 


2 

| 
| [UPCASE] | NOTRC| 
| L J 


She) | nembernane 
L 


Io 5 
In 
lnm 


ae | cr 

alae i a * | 
; 
J 


where: 

fn is the filename of the file to be printed. 

ft is the filetype of the file to be printed. 

fo is the filemode of the file to be printed. If this field is 
specified as an asterisk (*), the standard order of search is 
followed and the first file found with the given filename and 
filetype is printed. If fm is not specified, the A-disk and 
its extensions are searched. 

Options: 


CC [ HEADer ] 

interprets the first character of each record as a carriage 
control character. If the filetype is LISTING or LIST3800, the 
CC option is assumed. If CC is in effect, the PRINT command 
heither performs page ejects nor counts the number of lines per 
page; these functions are controlled by the carriage control 
characters in the file. The LINECOUN option has no effect if CC 
is in effect. 


HEADer creates a header page with only the filename, filetype and 
filemode at the top of the page. The records in the file being 
printed begin on anew page following the header page. The 
HEADER option can only be used in conjunction with the CC option. 
If the CC option is not specified HEADer has no effect. 


NOCC does not interpret the first character of each record as a 
carriage control character. In this case, the PRINT command 
ejects a new page and prints a heading after the number of lines 
specified by LINFCOUN are printed. If NOCC is specified, it is 
in effect even if CC was specified previously or if the filetype 
is LISTING. 


UPCASE 

UP 
translates the lowercase letters in the file to uppercase for 
printing. 
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TRC 


NOTRC 


LINEC 
LI 


MEMBE 
MEM 


HEX 


PRINT 


interprets the first data byte in each record as a TRC (Table 
Reference Character) byte. The value of the TRC byte determines 
which translate table the 3800 printer selects to print a record. 
The value of the TRC byte corresponds to the order in which you 
have loaded WCGMsS (via the CHARS keyword of the SETPRT command). 
Valid values for TRC are 0, 1, 2, and 3. If an invalid value is 
found, a TRC byte of 0 is assumed. If the filetype is LIST3800, 
TRC is assumed. 


does not interpret the first data byte in each record as a TRC 
byte. NOTRC is the default. 


OUN { nn 
22 


allows you to set the number of lines to be printed on each page. 
nn can be any decimal number from 0 through 99. If a number is 
not specified, the default value is 55. If nn is set to zero, 
the effect is that of an infinite line count and page ejection 
does not occur. This oftion has no effect if the CC option is 
also specified. 


R * 
O uavecaned 
prints the members of macro cr text libraries. This option may be 
specified if the file is a simulated partitioned data set 
(filetype MACLIB or TXTLIE). If an asterisk (*) is entered, all 
individual members of that library are printed. If a membername 
is specified, only that member is printed. 


prints the file in graphic hexadecimal format. If HEX is 
specified, the opfticns CC and UPCASE are ignored, even if 
specified, and even if the filetype is LISTING. 


Usage Notes 


1. 


The file may contain carriage control characters and may have 
either fixed- or variable-length records, but no record may exceed 
132 characters for a 1403, 3203, or 3289 Model 4 printer or 150 
characters for a 3211 frinter. There are exceptions: 


e If the CC oftion is in effect, the record length can be one 
Character longer (133 or 151) to allow for the carriage control 
character. 


e If the virtual printer is a 3800, you can specify a carriage 
control byte, a TRC Lyte, or roth, for a total line length of up 
to 206 bytes. 


e If the HEX option is in effect, a record of any length can be 
printed, up to the CMS file system maximum of 65,535 bytes. 


If you want the first character of each line to be interpreted as a 
Carriage control character, you must use the CC option. When you 
use the CC option for files that do not contain carriage control 
characters, the first character of each line is stripped off. An 
attempt is made to interpret the first character for carriage 
control purposes. If the character is not valid, the results are 
unpredictable because CMS does not check for valid carriage control 
characters. 


Files with a filetype of UPDLOG (produced by the UPDATE command) 
must be printed with the CC option. 


If the virtual printer is not a 3800 and you have’ specified TRC, 
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PRINT 


PRINT strips off the first data byte before each line is printed. 


4. One spool printer file is froduced for each PRINT command; for 
example: 


print mylik maclik (member get 


prints the member GET from the file MYLIB MACLIB. If you want to 
print a number of files as a single file (so that you do not get 
output separator pages, for example), use the CP command SPOOL to 
Spool your virtual printer with the CONT option. 


5. If the MEMBER option is specified more than once, only the last 
member specified will ke printed. However, if one MEMBER option is 
coded with an asterisk (*), and another MEMBER option is specified 
with a membername, only the specified member will be printed, 
regardless of their order on the command line. 


For example, if you code; 

PRINT ONE MACLIE (MEMBER EXAMPLE1 MEMBER EXAMPLE2 
only EXAMPLE2 will he frinted. If you code; 

PRINTER ONE MACLIE (MEMBER EXAMPLE1 MEMBER * 


only EXAMPLE1 will ke printed. 


Responses 


None. The CMS ready message indicates the command completed without 
error (that is, the file is written to the spooled printer). The file 
is now under the control of CP spooling functions. If acCP SPOOL 
command option such as HOLD or COPY is in effect, you may receive a 
message from CP. 


Other Messages and Return Codes 


DMSPRTOO2ZE FILE ‘fn ft fm" NCT FOUND RC=28 

DMSPRTOO3E INVALID OPTION ‘option’ RC=24 

DMSPRTOO8E DEVICE ‘cuu!' {INVALID OR NONEXISTENT(UNSUPPORTED DEVICE TYPE} 
RC=36 

DMSPRTO13E MEMBER '‘name* NOT FOUND IN LIBRARY RC=32 

DMSPRTO29E INVALID PARAMETER ‘parameter' IN THE OPTION ‘option! FIELD 
RC=24 

DMSPRTO33E FILE ‘fn ft fm' IS NOT A LIBRARY RC=32 

DMSPRTO39E NO ENTRIES IN LIBRARY ‘fn ft £fm* RC=32 

DMSPRTOG4E RECORD LENGTH EXCEEDS ALLOWABLE MAXIMUM RC=32 

DMSPRTO4Y8E INVALID MODE ‘mode* RC=24 

DMSPRTOSYE INCOMPLETE FILEID SPECIFIED RC=24 

DMSPRTO62E INVALID * IN FILEID RC=20 

DMSPRTO69E DISK ‘mode NOT ACCESSED RC=36 

DMSPRTO7OE INVALID PARAMETER ‘parameter' RC=24 

DMSPRT104S ERROR 'nn* READING FILE ‘fn ft fm' FROM DISK RC=100 

DMSPRT123S ERROR PRINTING FILE ‘fn ft fm' RC= 100 


248 IBM VM/SP CMS Command and Macro Reference 


PSERV 


PSERV 


Use the PSERV command in CMS/DOS to copy, display, print, or punch a 
procedure from the VSE procedure library. The format of the PSERV 
command is: 


procedure [ [ (options... [) J] 
[ 


options: 
CDISK] [PRINT] 
[P 


=—me ee eee eee ee ee 
tad 


UNCH] [TERM] 


A i ee ee eS eee 


where: 

procedure 
specifies the name of the procedure in the VSE procedure 
library that you want to copy, print, punch, or display. 

ft specifies the filetype of the file to be created on your 


A-disk. ft defaults to PROC if a filetype is not specified; 
the filename is always the same as the procedure name. 


Options: You may enter as many options as you wish, depending on the 
functions you want to perforn. 


DISK copies the procedure to a CMS file. If no options are 
specified, DISK is the default. 


PRINT spools a copy of the procedure to the virtual printer. 
PUNCH spools a copy of the procedure to the virtual punch. 


TERM displays the procedure on your terminal. 


Usage Notes 
1. You cannot execute VSE procedures in CMS/DOS. You can use the 
PSERV command to copy an existing VSE procedure onto a CMS disk, 
use the CMS Editor to change or add VSE job control statements to 
it, and then spool it to the reader of a VSE virtual machine for 
execution. 


2. The PSERV command ignores current assignments of logical units, and 
directs output according to the option list. 


3. The PSERV command does not support a private procedure library. 


Responses 


When you issue the TERM option, the procedure is displayed at your 
terminal. 
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PSERV 


Error Messages and Return Codes 


DMSPRVOO3E 
DMSPRVOO4E 
DMSPRVOO6E 
DMSPRVO37E 
DMSPRVO7OE 
DMSPRVOQ7E 
DMSPRVO98E 
DMSPRVO99E 
DMSPRV105S 
DMSPRV113S 
DMSPRV411S 


INVALID OPTION ‘option' 
PROCEDURE 'procedure' 


NO READ/WRITE ‘A* 


DISK "A* IS READ/ONLY 
INVALID PARAMETER ‘parameter' 


DISK ACCESSED 


RC=24 


NOT FOUND RC=28 


RC=36 


NO "SYSRES* VOLUME ACTIVE RC=36 


NO PROCEDURE NAME SPECIFIED RC=24 
CMS/DCOS ENVIRONMENT NOT ACTIVE 
ERROR nn! WRITING 


FILE 


DISK ({cuu) NOT ATTACHED 


INPUT ERROR CODE 


tnn?* 


ON 


"fn ft fat 
RC=100 
*SYSRES'* 


RC=36 


RC=24 


RC=40 


TO DISK 


RC=100 
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RC=100 


PUNCH 


Use the 


PUNCH 


PUNCH command to punch a CMS disk file to your virtual card 


punch. The format of the FUNCH command is: 


PUnch 


ae epee oe 2 eae see ow Oe ee 2 Le 


eres ee4 
L 


z 
fn| [ (options...[) ]] options: 
* | 

J 


= 
; 


MEMBER jf * 
nembernane{ | 
J 


— ee ees eee eee eee ee ee ee 


where: 
fn is the filename of the file to be punched. This field must be 
specified. : 
ft is the filetype of the file to be punched. This field must be 
specified. 
fn is the filemode of the file to be punched. If you specify it 
as an asterisk (*), the standard order of search is folloved 
and the first file found with the specified filename and 
filetype is punched. If fm is nct specified, your A-disk and 
its extensions are searched. 
Options: 
HEADER 
inserts a control card in front of the punched output. 
H This control card indicates the filename and filetype fora 


subsequent READCARD command to restore the file to a disk. 
The control card format is shown in Figure 26. 


NOHEADER NOH 


MEMBER 
MEM 


does not punch a header control card. 


* 

yacanecnan: 

punches members of MACLIBS or TXTLIBs. If an asterisk (*) is 
entered, all individual members of that macro or text library 
are punched. If membername is specified, only that member is 
punched. If the filetype is MACLIB and the MEMBER membernane 
option is specified, the header contains MEMBER as_ the 
filetype. If the filetype is TXTLIB and the MEMBER membernane 
option is specified, the header card contains TEXT as the 
filetype. 
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PUNCH 


tt 
i {Number of | | | 
| Cclumn|Characters|Contents| Meaning i 
l [ 
{| 1 | 1 |: jJIdentifies card as a control card. | 
l ; 4 ; l 
{| 2 | 4 | READ {Identifies card as a READ control card. | 
H | [ i | 
{| 6— i 2 j tblank i [ 
l | l { | 
| 815 | 8 | fnane {Filename of the file punched. | 
l | [ ; | 
| 16 | 1 | blank | [ 
[ ; d ; | 
{17-24 | 8 Jftype [Filetype of the file punched. | 
{ [ l [ | 
{25 | 1 | blank j l 
[ | ! i l 
[26—27 | 2 ifmode [Filemode of the file punched. | 
[ | i | i 
{28 | 1 | blank i l 
| | l [ [ 
{29-34 | 6 | volid [Laktel of the disk from which the file was | 
l ; i | read. i 
| [ l | H 
{35 | 1 | blank 4 | 
[ | | | | 
[36-43 | 8 jmum/dd/yy|The date that the file was last written. | 
[ | I | | 
y44a—45 | 2 | klank I | 
l | | | | 
146-50 | 5 Jhhson [|The time of day that the file was written | 
l [ i | to disk. | 
i ; | ; i 
151-80 -| 30 | Llank | i 


Figure 26. Header Card Format 


Usage Notes 


1. 
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You can punch fixed- or variable-length records with the PUNCH 
command, as long as no record exceeds 80 characters. Records with 
less than 80 characters are right-padded with blanks. Records 
longer than 80 characters are rejected. 


If you punch a MACLIB or TXTLIB file specifying the MEMBER * 
option, a read control card is placed in front of each library 
member. If you punch a library without specifying the MEMBER * 
option, only one read control card is placed at the front of the 
deck. 


One spool punch file is produced for each PUNCH command; for 
example: 


punch compute assegble (noh 
punches the file COMPUTE ASSEMEFLE, without inserting a header card. 
To transmit multiple CMS files as a single punch file, use the CP 
SPOOL command to spool the punch with the CONT option. 
If the MEMBER option is specified more than once, only the last 


member specified will be punched. However, if one MEMBER option is 
coded with an asterisk (*), and another MEMBER option is specified 
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PUNCH 


with a membername, only the member specified by membername will be 
punched, regardless of their order on the command line. 


For example, if you code: 

PUNCH ONE MACLIE (MEMBER EXAMPLE1 MEMBER EXAMPLE2 
only EXAMPLE2 will be punched. If you code: 

PUNCH ONE MACLIB (MEMBER EXAMPLE1 MEMBER * 
only EXAMPLE1 will be punched. 


5. When punching nembers from CMS maclibs, each member is followed by 
a // record, which is a maclib delimiter. You can edit the file to 
delete the // record 


Responses 


None. The CMS ready message indicates that the command completed 
without error (the file was successfully spooled); the file is now under 
control of CP spooling functions. You may receive a message from CP 
indicating that the file is keing spooled to a particular user's virtual 
card reader. 


Other Messages and Return Codes 


DMSPUNOO2ZE FILE ‘fn ft f£m' NCT FOUND RC=28 

DMSPUNOO3E INVALID OPTION ‘option RC=24 

DMSPUNOOSE DEVICE ‘cuu! {INVALID OR NONEXISTENT|UNSUPPORTED DEVICE TYPE} 
RC=36 

DMSPUNO13E MEMBER ‘name NOT FOUND IN LIBRARY kRC=32 

DMSPUNO33E FILE 'fn ft fm' IS NOT A LIBRARY RC=32 

DMSPUNO39SE NO ENTRIES IN LIERARY ‘fn £t £m* RC=32 

DMSPUNOSYE RECORD LENGTH EXCEEDS ALLOWABLE MAXIMUM RC=32 

DMSPUNOS4E INCOMPLETE FILEID SPECIFIED RC=24 

DMSPUNO62E INVALID * IN FILFID RC=20 

DMSPUNO69E DISK ‘mode NOT ACCESSED RC=36 

DMSPUN104S ERROR ‘nn! READING FILE "fn £t fm" FROM DISK RC=100 

DMSPUN118S ERROR PUNCHING FILE "fn ft fm" RC=100 
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QUERY 
QUERY 


Use the QUERY command to gather information about your CMS virtual 
machine. You can determine: 


e The state of virtual machine characteristics that are controlled by 
the CMS SET command 


e File definitions (set with the FILEDEF and DLBL commands) that are in 
effect 


e The status of accessed disks 


e The status of CMS/DOS functions 


The format of the QUERY command is: 


BLIP r + 
RDYMSG | (options... [)] | 
LDRTBLS = = 
RELPAGE 
IMPCP 
IMPEX 
ABBREV Options: 
REDTYPE 
PROTECT 
INPUT r 
OUTPUT | STACK [FIFO]| LIFO] 
SYSNAMES | FIFO 
SEARCH | LiIFO 

L 


Query 


bee ee ee ee ol 


node 
DISK * 
R/W 
MAX 


oes | 
ALL 


SYNONYM jose 


FILEDEF 
LABFLDEF 
MACLIB 
LOADLIB 
TIXTLIB 
LIBRARY 
CMSLEVEL 


CMS/DOS Functions: 


DLBL 

DOS 
DOSLIB 
DOSPART 
DOSLNCNT 
OPTION 
UPSI 
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Operands for Functions that Can Be Controlled Via the SET Command: 


BLIP 


RDYMSG 


LDRTBLS 


RELPAGE 


IMPCP 


IMPEX 


displays the BLIF character(s). 


Response: BLIP = aca 
OFF 


displays the format of the CMS ready message. 
Response: RDYMSG = emer 
SMSG 
where: 
LMSG is the standard CMS ready message: 
R; T = 0.12/0.33 17:06:20 
SMSG is the shortened CMS ready message: 


R; 


displays the number of loader tables. 


Responses: LDRTBLS = nna 


indicates whether pages of storage are to be released or 
retained after certain commands complete execution. 


Response: RELPAGE = e } 
OFF 


where: 


ON releases pages. 
OFF retains pages. 


displays the status of implied CP command indicator. 


Response: IMPCP = ie 
OFF 


where: 


ON indicates that CP commands can be entered from the CMS 
environment. 

OFF indicates that you must use the CP command or the #CP 
function to enter CP conmands from the CMS 
environspent. 


displays status of implied EXEC indicator. 


Response: IMFEX = {ON 
OFF 


where: 
ON indicates that EXEC files can be executed by entering 
the filename of the file. 


OFF indicates that the EXEC command must be explicitly 
entered to execute EXEC files. 
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ABBREV 


REDTYPE 


PROTECT 


INPUT 


OUTPUT 


displays the status of the minimum truncation indicator. 


Response: ABBREV = jON 
OFF 


ON indicates that truncations are accepted for CMS 
commands. 
OFF indicates that truncations are not accepted. 


displays the status of the REDTYPE indicator. 


Response: REDTYPE = ee \ 
OFF 


where: 

ON types CMS error messages in red, for certain terminals 
equipped with the appropriate terminal feature and a 
two-color rikbon. Supported terminals are described in 
the VWH/SP Jerminal User's Guide. 


OFF does not type CMS error messages in red. 


displays the status of CMS nucleus protection. 


Response: PROTECT = oe } 
OFF 


where: ) 


ON means CMS nucleus protection is in effect. 
OFF means CMS nucleus frotection is not in effect. 
displays the contents of any input translate table in effect. 
esponse: INPUT at xxl 
an xxn 


If you do not have an input translate table in effect, the 
response is: 
NO USER DEFINED INPUT TRANSLATE TABLE IN USE 


displays the contents of any output translate table in effect. 


Response: OUTPUT xx1 ati 


If you do not have an output translate table defined, the 


response is: 
oa 
NO USER DEFINED OUTPUT TRANSLATE TABLE IN USE 2 
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SYSNAMES displays the names of the standard saved systems. 


Response: SYSNANES: CMSSEG CMSVSAM CMSAMS CMSDOS 
ENTEIES: entry... entry... Entry... Entry... 


where: 


SYSNAMES are the standard hanes that identify the 
discontiguous saved systens. 


ENTRIES are the standard system default names or the systen 
hames established via the SET SYSNAME command. 


Operands for CMS Disk Status Functions: 


SEARCH displays the search order of all disks currently accessed. 


rc | 

Response: label cuu mode jR/O\| |-OS | 
R/Wf {-DOS| 

@e @ e @ & J 


label is the label assigned to the disk when it was 
formatted; or, if it is an OS or DOS disk, the volume 
label. 

cuu is the virtual device address. 

node is the filemode letter assigned to the disk when it was 
accessed. 


of the disk. 


ean indicates whether read/write or read-only is the status 
& 
| indicates an OS or DOS disk. 

| 

J 


DISK mode displays the status of the single disk represented by "mode". 


Response: 
LABEL CUU M STAT CYL TYPE BLKSIZE FILES BLKS USED-(%) BLKS LEFT BLK TOTAL 
label cuu m {R/O( cyl type blksize nnnon nnnn-aAn nnnn nonon 
R/i 
If the disk is an OS or DOS disk, the response is: 
LABEL CUU M STAT CYL TYPE BLKSIZE FILES BLKS USED-(%) BLKS LEFT BLK TOTAL 


label cuu o tee {eH type OSs 
R/Wf EBA Dos 
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label is the label assigned to the disk when it was 
formatted; or, if it is an OS or DOS disk, the volume 


label. 
cuu is the virtual device address. 
n is the access pode letter. 


pe STAT indicates whether read/write or read-only 
R/W is the status of the disk. 


cyl is the number of cylinders available on the disk. For 
an FB-512 device, this field contains the notation 
"FBA' rather than the number of cylinders. 


type is the device type of the disk. 


blksize 
is the CMS disk block size when the minidisk was 
formatted. 

nnnn FILES 


is the number of CMS files on the disk. 


nnnn BLKS USED 
indicates the number of CMS disk blocks in use. 


nh % indicates the percentage of blocks in use. 

nnnon BLKS LEFT 
indicates the number of disk blocks left. This isa 
high approximation because control blocks are included. 


Hnnonn BLK TOTAL 
indicates the total number of disk blocks. 


{oo ; indicates an OS or DOS disk. 
DOS 


If the disk with the specified mode is not accessed, 
the response is; 


DISK ‘mode't NOT ACCESSED 


DISK * displays the status of all CMS disks. 


Response: Is the same as for QUERY DISK mode; one line is 
displayed for each accessed disk. 


DISK R/W displays the status of all CMS disks that have been accessed in 
the Read/Write mode. 


Response: Is of the same format as QUERY DISK mode; one header 


is displayed followed by one line for each accessed CMS 
Read/Write disk. 


DISK MAX displays the status of the CMS disk accessed in Read/Write node 
having the most availatle espace. 
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Response: Is of the same format as QUERY DISK mode; a header 
and one line are displayed for the CMS Read/Write disk with the 


most available space. 


Other Functions: 


SYNONYM SYSTEM 
displays the CMS system synonyms in effect. 


Response: SYSTEM SHORTEST 
COMMAND FORM 


command pininbun truncation 


If no system synonyms are in effect, the following message is 
displayed at the terminal: 


NO SYSTEM SYNONYMS IN EFFECT 


SYNONYM USER 
displays user synonyms in effect. 


Response: SYSTEM USER SHORTEST 
COMMAND SYNONYM FORM (IF ANY) 


command synonym minimum truncation 


If no user synonyms are in effect, the following message is 
displayed at the terminal: 


NO USER SYNONYMS IN EFFECT 


SYNONYM ALL 
displays all synonyms in effect. 


Response: The response to the command QUERY SYNONYM SYSTEM is 
followed by the response to QUERY SYNONYM USER. 


FILEDEF displays all file definitions in effect. 


Response: ddname device [fn [ft]] 


If no file definitions are in effect, the following message is 
displayed at the terminal: 


NO USER DEFINED FILEDEF'S IN EFFECT 
LABELDEF displays all label definitions in effect. 


Response: ddname volid fseq volseg genn genv crdte exdte fid 
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MACLIB 


TXTLIB 


LOADLIB 


LIBRARY 


Only fields you have explicitly specified are displayed. 
Defaulted fields are not displayed. If no label definitions 
are in effect, the following message is displayed at the 
terminal: 


NO USER DEFINED LABELDEF'S IN EFFECT 
displays the names of all files, with a filetype of MACLIB, 
that are to be searched for macro definitions (that is, all 
MACLIBS specified on the last GLOBAL MACLIB command, if any). 
Response: MACLIB = likname... 


If no Macro libraries are to be searched for macro 
definitions, the response is: 


MACLIB = NONE 


displays the names of all files, with a filetype of TXTLIB, 
that are to ke searched for unresolved references (that is, 
all TXTLIBS specified on the last GLOBAL TXTLIB command, if 
any). 


Response: TXTLIE = likname... 


If no TXTLIBs are to be searched for unresolved references, 
the following message is displayed at the terminal: 


TXTLIB = NONE 
displays the names of all files, that have a filetype of 
LOADLIB, that are to be searched for load modules (that is, 
all LOADLIBs specified on the last GLOBAL LOADLIB command, if 
any). 
Response: LOALLIE = likname... 


If no LOADLIBs are to be searched, the following message is 
displayed at the terminal: 


LOADLIB = NONE 


displays the names of all library files with filetypes of 
MACLIB, TXTLIB, DOSLIB, and LOADLIB that are to be searched. 


Response: MACLIB = likname... 
NONE 
TXTLIE = libnane... 
NONE 
DOSLIE = likname... 
NONE 
LOADLIB = {libname... 
NONE 
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QUERY 


returns the feature or program product, release, and the 
service level of CMS. Refer to the CMSLEVEL macro for issuing 
CMSLEVEL in a progran. 


Response: Displays the VM/SP Release Level and the Service 
Level. 


for example; VM/SP RELEASE 2, SERVICE LEVEL 102 


CMS/DOS Functions: 


DLBL 


in order to display the contents of the current data set 
definitions, it is necessary only to enter: 


DLBL or QUERY CLBL 
Entering the command yields the following information: 
DDNAME the VSE filename or OS ddname. 


MODE the CMS disk mode identifying the disk on which the 
data set resides. 


LOGUNIT the VSE logical unit specification (SYSxxx). This 
operand will be blank for a data set defined while 
in cCMS/OS environment; that is, the SET DOS ON 
command had not been issued at DLBL definition time. 


TYPE indicates the type of data set defined. This field 
may only have the values SEQ (sequential) and VSAM. 


CATALOG indicates the ddname of the VSAM catalog to be 
searched for the specified data set. This field 
will be blank for seguential (SEQ) dataset 
definiticns. 


EXT specifies the number of extents defined for the data 
set. The actual extents May be displayed by 
entering either the DLBL (EXTENT) or the QUERY DLBL 
EXTENT command. This field will be blank if no 
extents are active for a VSAM data set or if the 
data set is sequential (SEQ). 


VOL specifies the number (if greater than one) of 
volumes cn which the VSAM data set resides. The 
actual volumes may be displayed by entering either 
the DLEL (MULT) or the QUERY DLBL MULT commands. 
This field will be blank if the VSAM data set 
resides only on one volume or if the data set is 
sequential (SEQ). 


BUFSP indicates the size of the VSAM buffer space if 
entered at DLBL definition time. This field will be 
blank if the dataset is sequential (SEQ). 


PERM indicates whether the DLBL definition was made with 
the PERM option. The field will contain YES or NO. 


DISK indicates whether the data set resided on a CMS or 
DOS/OS disk at DLBL definition time. The values for 
this field are DOS and CMS. 

DATASET. NAME 
for a data set residing on a CMS disk, the CMS 
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DOS 


DOSLIB 


DOSPART 


DOSLNCNT 


OPTION 


UPSI 


filename and filetype are given; for a data _ set 

residing on a JLCOS/OS disk, the data set name , 
(maximum 44 characters) is given. This field will ; 
be blank if no DOS/OS data set name is’ entered at 

DLBL definition time. 


If no DLBL definitions are active, the following message is 
issued: 


DMSDLB324I NO USER DEFINED DLBL'S IN EFFECT 


displays whether the CMS/DOS environment is active or not. 


Response: DOS = fON 
OFF 


displays the names of all files with a filetype of DOSLIB that 
are to be searched for executable phases (that is, all DOSLIBs 
specified on the last GLOBAL DOSLIB command, if any). 


Response: DOSLIB = flikname saa 
NCNE 


displays the current setting of the virtual partition size. 


Response: f nnnnnk 
NONE 


nnonnK indicates the size of the virtual partition to be used 
at program execution time. 


NONE indicates that CMS determines the virtual partition J 
size at program execution time. 


displays the number of SYSLST lines per page. 

Response: DOSLINCNT = nn 

where: 

hn iS an integer from 30 to 99. 

displays the compiler options that are currently in effect. 
Response: OPTION = options... 

displays the current setting of the UPSI byte. The eight 
individual bits are displayed as zeros or ones depending upon 
whether the corresponding bit is on or off. 


Response: UPSI = nannnnoan 


262 IBM VM/SP CMS Command and Macro Reference 


QUERY 


STACK causes the results of the QUERY command to be placed ia the 
program stack instead of Lleing displayed at the terminal. The 
information is stacked either FIFO (first in first out) or 
LIFO (last in first out). The default order is FIFO. 


If CMS passes the command tc CP, then the response from CP is 
also put in the frogram stack. If CP precedes the QUERY 
command, CMS does not stack the results. The STACK option is 
valid only when issued from CMS. 


FIFO (first-in first-out) is the default option for STACK. FIFO 
causes the results of the QUERY command to be placed in the 
program stack instead of keing displayed at the terminal. The 
information is stacked FIFO. The options STACK, STACK FIFO, 
and FIFO are all eguivalent. 


LIFO (last-in first-out) causes the results of the QUERY command to 
be placed in the program stack rather than being displayed at 
the terminal. The information is stacked LIFO. This option 
is equivalent to STACK LIFO. 


Usage Notes 


1. You may specify only one QUERY parameter at a time. 


2. If the implied CP (IMPCP) function is in effect and you enter an 
invalid QUERY parameter, you may receive the message DMKCQGO45E - 
userid NOT LOGGED CN. 


3. If an invalid QUERY parameter is specified from an EXEC and the 
implied CP (IMPCP) function is in effect, then the return code is 
-0003. 


4. The DOSPART, OPTION, and UPSI functions are valid only if the 
CMS/DOS environment is active. 


5. When the STACK option is specified, the header is included in the 
program stack. 


Error Messages and Return Codes 


DMSQRYOOSE NO "option! SPECIFIED RC=24 

DMSQRYO14E INVALID FUNCTION 'function* RC=24 

DMSQRYO26E INVALID PARAMETER ‘parameter’ FOR ‘function! FUNCTION RC=24 
DMSQRYO47E NO FUNCTICN SPECIFIED RC=24 

DMSQRYO7OE INVALID PARAMETER ‘parameter’ RC=24 

DMSQRYO99E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 
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Use RDR to determine the characteristics of the next file in your 
virtual reader. RDR generates a return code and either displays or 
stacks a message for each type of file recognized. Which file is "next" 
depends upon the class of the reader, the class of the files in the 
reader, and whether or not they are held. The format of the RDR command 
is: 


spool-class| [ (options...[) ]] 
= | 


J 


RDR 


| lion | 


options: 


2 
| NOTYPE 

| STACK [FIFO | LIFO] 
| FIFO 


| LIFO 
L 


ee ee Oe a Oe eo eee ee eee eo eee ee ee 
bes es es ee ee 


=e Gee Se eee eee Gee eee oes ee eee Ee ee ee eee 
= Ge eet ee eee ee eee ee ee eee oe OE Ee 


where: 

spool-class is the class of the spool file for which information is 
to be returned. The virtual reader remains spooled to 
the class specified in the RDR command. 

= indicates that iiformation is to be returned for a file 
having the same spocl file class as that of the virtual 
reader. This is the default. 

NOTYPE specifies that no message is to be displayed or stacked. 


However, a return code is generated, which is accessible 
from within an EXEC 2 (or EXEC) procedure, by examining 
the variable &RC (or &RETCODE). 


STACK [ FIFO| LIFO] 
specifies that the message is placed in the program stack 
rather than displayed at the terminal. The information 
is stacked either FIFO (first in first out) or LIFO (last 
in first out). ‘The default order is FIFO. 


FIFO specifies that the information is placed in the progran 
stack rather than displayed at the terminal. The 
information is stacked FIFO. The options STACK, STACK 
FIFO, and FIFO are all equivalent. 


LIFO specifies that the information is placed in the progran 
stack rather than displayed at the terminal. The 


information is stacked LIFO. This option is equivalent 
to STACK LIFO. 


Usage Notes: 


1. Issued with no options, RDR displays the return code and message. 


2. Issued with the NOTYPE option from an EXEC, RDR places a return 
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code in the variable &RC (or E&RETCODE). Appropriate action can be 
taken by examining this variable. For example: 


RDR (NOTYPE 
GIF GRC = 22 SCOMMAND DISK LOAL 
GIF &RC = 7 SCOMMAND READCARD 


3. If the spool-class specified is different from the current spool 
class of the virtual reader, the virtual reader's spool class is 
changed to the one specified. The current spool class of the 
virtual reader can be determined by issuing the CP command QUERY 
VIRTUAL OOC or QUERY VIRTUAL UR. 


4. The RDR command changes the order of the files in your virtual 
reader. Files that are not held are re-ordered according to class. 


Responses 


The return codes and messages are: 


0 READER EMPTY 

1 SYSTEM DUMP FILE 

2 PRINTER FILE (ITEM LENGTH 132) 

3 DISK LOAD fn ft fn 

4 sREAD fn ft £m originid munydd/yy hh:mm:ss 
5 CARDS FOR IPL 

6 UNNAMED CARD LECK 

7 READ fn ft fn 

9 READER NOT OPERATIONAL 

13 READER NOT REALY 


18 CONSOLE SPOOL FILE 
22 DISK LOAD fn ft fo 
23 NETDATA FILE 

26 MESSAGE 


Explanations of the messages follow. (The return code is not part of 
the message.) 


READER EMPTY kRC=0 

The reader is empty, the reader file is held, or there are no files in 
the reader of the current reader spool class. You can check to make 
sure the reader corresrfonds to the current spool class, or check for 
held files. 


SYSTEM DUMP FILE RC=1 
The reader contains a system dump file, which can be handled using the 
appropriate system utility. 


PRINTER FILE (ITEM LENGTH 132) RC=2 
The reader contains an unnamed frinter file. 


DISK LOAD fn ft fm RC=3 

The reader contains a file sent via DISK DUMP from a VH/370 Release 6 
(or earlier version) CNS file system. The CMS file system in VM/370 
Release 6 (or earlier) only supports minidisks formatted in 800-byte 
physical blocks. 


sREAD fn ft fm originid mm/dd/yy hh:mm:ss RC=4 
The reader contains a file produced by the PUNCH command. 


CARDS FOR IPL RkRC=5 


The reader contains a file that has IPL cards as the first cards in the 
file. 
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UNNAMED CARD DECK RC=6 


The reader contains 


‘RFAD fn ft fm RC=7 


The reader contains 


a PUNCH file that can not be identified. 


a file produced by the PRINT command. 


READER NOT OPERATIONAL RC=9 

The reader is not operational: device 00C does not exist in the virtual 
machine configuration or device 00C is not a reader. Possible causes: 
the reader is not defined in the directory; the reader was detached; 
some other device was at QOC. (CMS assumes the reader to be at address 


O0C.) 


READER NOT READY RC=13 
The reader is not ready. To reverse the not ready status, issue the CP 


command READY OOC. 


CONSOLE SPOOL FILE 
The reader contains 


DISK LOAD fn £t fm 
The reader contains 
6 CMS file systen. 
by the VWM/370 file 
formatted in 1024-, 


NETDATA FILE RC=23 
The reader contains 
the NEW option. 


MESSAGE RC=26 
The reader contains 
virtual machine. 


RC=18 
a file that is from a console. 


RC=22 

a file sent via DISK DUMP from a post-VM/370 Release 
In addition to the 800-byte physical blocksize used 
system, the enhanced file system supports nminidisks 
2048-, or 4096-byte logical blocks. 


a file that was sent using the SENDFILE command with 


a file that is a message that was sent from an RSCS 


Other Messages and Return Codes 


DMSRDRO7VOE INVALID PARAMETER ‘parm’. RC=24 
DMSRDR630S ERROR ACCESSING SPOOL FILE. RC=36 
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Use the RDRLIST EXEC procedure to display information about the files in 
your virtual reader. The RDRLIST environment is controlled by the 
System Product editor. Therefore, you can use XEDIT subcommands' to 


manipulate the files. In addition, you can look at a given reader file, 
discard it, copy it to a CMS mini-disk, or send it to someone else 
(local or remote). 


In most cases these files were sent to you by other computer users, on 
your computer or on other computers that are connected to yours via the 
Remote Spooling Communications Subsystem (RSCS) network. 


The format of the RDRLIST command is: 


Foe eae ee fg eet one 
|RDRList | [ (options...j) ]] | 
| RList | | 
| | options: ! 
| | [ PROFile fn] i 
| | [ Append ] | 
ae cee eee! (SS eee a ae a a ee eee wn en a ee cee ee ee 
where 


PROFile fn specifies the name of an XEDIT macro to be executed when 
XEDIT is invoked by the RDRLIST command. If not specified, 
the default macro FROFRLST XEDIT is invoked. For more 
information on the PROFRLST macro, see the usage note, 
"Default PF Key Settings." 


Append specifies that the list of files in your reader should be 


appended to the existing list. This option has meaning only 
when issued from within RDRLIST, and is ignored otherwise. 


Usage Notes: 


1. Tailoring the RDRLIST Command Options 
You can use the DEFAULTS ccmmand to set up options and/or override 
command defaults for RDRLIST. However, the options you specify in 
the command line when entering the RDRLIST command override those 
specified in the DEFAULTS command. This allows you’ to customize 
the defaults of the RDRLIST command, yet override them when you 
desire. Refer to the DEFAULTS command description for more 
information. 

2. Format of the List 
When you invoke the RDRLIST command you are placed in the XEDIT 
environment, editing a file “userid RDRLIST A1". The existing copy 
of this file is erased if it exists. 


The file you are editing is alist of files with information 
collected from the CP QUERY RDR ALL command. Each line contains: 


e a command area 
e filename and filetype 
e class and type 


e number of records 
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e whether or not the file is held 
e creation date and tine 
e originating userid and node 


The full power of XEDIT is available to you while you issue 
commands against the list of files. For example, you may want to 
use XEDIT subcommands to scroll through the list of files, locate a 
particular file, etc. 


However, some XEDIT subcommands acre inappropriate in this 
environment. Subcommands that alter the format or the contents of 
"userid RDRLISI" (for example, SET TRUNC, SET FIYPE, or SET LINEND) 
May Cause unpredictable results. 


3. Issuing Commands from the List 


On a full screen display, you can issue commands directly from the 
line on which a reader file is displayed. These commands must be 
CP or CMS commands that operate on reader files (for example, 
CHANGE RDR, PURGE RDR, TRANSFER RDR, PEEK, DISCARD). For the above 
commands that operate on the reader files, the spoolid number is 
automatically appended to the end of the command. Use the slash 
(/) symbols described in below to specify the spoolid elsewhere in 
the command. For example: 


CHANGE RDR / CLASS A 
RECEIVE / fn ft ( REPLACE 


To enter a command, just move the cursor to the line that describes the 
file to be used by the command, and type the command in the space 
provided to the left of the filename. If a command is longer than the 
command space provided on the screen, just continue typing over the rest 
of the line. You press the PF10 key (not the ENTER key) to execute the 
command. (The default setting of PF10 is EXECUTE, which is described in 
the section "Special Commands", below.) 


For example, to purge a file, you would move the cursor up to that line 
on the screen, and type "discard" in the space provided to the left of 
the filename. DISCARD is another special command described in the 
section "Special Commands". When the PF10 key is pressed, all the 
commands typed on one screen are executed. The screen is restored to 
its previous state; however, the list is updated to reflect the current 
status of the files (see "Responses"). 


If you type a command on the RDRLIST screen and then press the ENTER key 
(oc a PF key other than PF10), the command is not issued immediately. 
This allows you to move through the list, and to enter commands on 
different lines of the list. 


Another way to issue commands that make use of the reader files 
displayed is to issue EXECUTE from the RDRLIST command line. A complete 
description of EXECUTE follows, in the section "Special Commands". 


4. Default PF Key Settings 
The PROFRLST xXEDIT macro is executed when the RDRLIST command is 


invoked, unless you specified a different macro in the RDRLIST 
command. It sets the PF keys to the following values: 


PF 1 Help Display RDRLIST command description. 

PF 2 Refresh Update the list to indicate discarded 
files, etc. 

PF 3 Quit Exit from RDRLIST display. 
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PF 4 Sort by filetype, filename. 

PF 5 Sort by date and time, oldest to newest. 

PF 6 Sort by userid, in alphaketical order. 

PF 7 Backward Scroll back one screen. 

PF 8 Forward Scroll forward one screen. 

PF 9 Receive Receive the file pointed to by the cursor 
(see the RECEIVE command). 

PF 10 Execute Execute command(s) typed on the 1ist. 

PF 11 Peek Display file where cursor is placed, but do not 
write it on disk. The file is displayed 
in the XEDIT environment. See also the 
PEEK command description. 

PF 12 Cursor Place cursor on current line. 


Note: On a terminal equipped with 24 PF keys, PF keys 13 to 24 are 
assigned the same values as PF keys 1 to 12 as discussed here. 


5. Displaying a File 
To display a file on the screen without reading it onto disk, 
position the cursor at the file you want to see and press the PF11 
key, which is set to the PEEK command. Refer to the PEEK command 
for more information on the PEEK screen. 

6. RDRLIST lists only the first 100 files in your virtual reader. 

Responses 


After a command is executed, one of the following symbols is displayed 
in the "Cnd" space to the left of the file for which it was executed. 


x 


*n 


*? 


*! 


Means the command was executed successfully (RC=0). 
Is the return code from the command executed (RC=n). 


Means the command was an unknown CP/CMS command (RC=-3). 


Means’ the command was not valid in CMS subset. You are 
automatically placed in CMS subset mode if the editor is not in the 
shared segment. For a list of commands valid in CMS subset mode, 


see the VM/SP System Product Editor Command and Macro Reference, the 
description of the CMS subconmmand. 


The following response can also appear on the RDRLIST screen: 


* 


spoolfn spoolft **Discarded or Received** 


The following response can also appear: 


No files in your reader. 


Error Messages and Return Codes 


DMSWRLOO3SE INVALID OPTION "option'. RC=24 

DMSWRL205E NO FILES IN YOUR REALER. RC=28 

DMSWRL637E MISSING VALUE FOR THE "PROFILE OPTION. kRC=24 
DMSWRL649E EXTRANEOUS PARAMETER ‘value'. RC=24 

DMSWRLO651E "APPEND! MUST BE ISSUED FROM RDRLIST OR FILELIST. RC=40 
DMSSTTO62E INVALID CHARACTER ‘character IN FILEID ‘fn ft". RC=20 
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Special Commands Used in the RDRLIST Environment 


Two commands, EXECUTE and DISCARD, make use of the list of files 
displayed by the RDRLIST command. EXECUTE can be used only in the 
RDRLIST and FILELIST command environments, and DISCARD can be used only 
in the RDRLIST, FILELIST, and PEEK command environments. 


EXECUTE 


Use EXECUTE (an XEDIT macro) to issue CP/CMS commands (or EXECS) that 
make use of the reader spool files displayed by RDRLIST. 


EXECUTE may be used in two ways. First, on a display terminal, the 
command(s) to be executed can be typed directly on the RDRLIST screen 
and "EXECUTE" entered either on the command line or from a PF key (the 
default for the PF10 key in the RDRLIST environment). Second, the 
command to be executed can be typed in the command line, following 
"EXECUTE", as one of its operands. The command is then executed against 
one or more reader files in the list. 


The format of the EXECUTE macro is: 


Grea re Pane ge are Se a een ER ee ge ee ee 

| EXECUTE| { Cursor|lines] [command ] \ 
Ee ee eee Ee —E—E——ee eee ee ee 
where: 

Cursor means that a command is to be executed against the line that 


contains the cursor. The command can either be typed on the 
line that describes the file, or it can be typed as an operand 
of EXECUTE. The CURSOR operand is valid only on display 
terminals and is particularly useful when assigned to a PF 
key. For example, if EXECUTE CURSOR PEEK is assigned to a PF 
key, you can place the cursor on the line describing the file 
you want to peek at and then press the PF key. 


lines is the number of lines inthe file the command is to be 
executed for. If a command is specified, the default is one 
(1). You can specify an asterisk (*), which means “execute 
this command on all lines from the current line to the end of 
the file". 


command is a CMS or CP command (or any program or EXEC) that makes use 
of reader spool files. You can either type out the command 
Operands, or you can use the symbols described below to 
represent the filename, filetype, spoolid, and device type. 
(See the usage note, "Using Symbols as Part of a Command".) 


Usage Notes 
1. Entering Commands on a Full Screen Display 


You can type commands that operate on reader spool files directly on 
the lines of the RDRLIST display. When you enter EXECUTE (either 
from the command line or by pressing the PF10 key), all commands 
entered on the lines in the file that are currently displayed are 
executed. The spoolid number of the reader file is appended 
automatically to the command, unless you typed one of the symbols 
described below (in usage note 3). 
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Entering Commands on the Command Line 


Another way to issue commands that make use of the files displayed 
is to move the current line to the first (or only) file you want the 
command to use, and then to issue the EXECUTE subcommand (in the 
form "EXECUTE lines command") from the XEDIT command line. This 
method may be used on both display and typewriter terminals. for 
example: 


First move the current line (by using XEDIT subcommands' like UP or 
DOWN) to the first file you want to use in the command. Ona full 
screen display, the current line is the first file on the screen and 
is highlighted. Then (in the XEDIT command line) you type: 

execute n peek 


where "n" is the number of lines to. be peeked, starting with the 
current line. (You can use any command, not just PEEK.) 


Note: You can use synonyms or macros to make issuing common 
commands easier. For example, you might want to set upa 
command "SEE" to be a synonym for “EXECUTE 1 PEEK". 

Using Symbols as Part of a Command 

Symbols can be used to represent operands in the command to be 
executed. They can be used in the commands typed on the list, or as 
part of the command in EXECUTE (on the command line). Symbols are 
needed if the command to be executed has operands or options that 
follow the command name. Examples of using symbols are in the 
"Examples" section, below. The following symbols can be used: 

WA means the spoolid of the file displayed on the line. 

/a weans the filename displayed on the line. 

7t means the filetype displayed on the line. 

fo means execute the line as is, without appending anything. 

7m means the device type (from which the file was sent). 

Any combinations of symbols can be used. For example: 

/a ft Means: filename followed by filetype. 

fut means: filename followed by filetype. 

Special Symbols Used Alone 


The following special symbols can be typed alone on the lines of the 
RDRLIST display. They have the following meanings: 


= means execute the previous command for this file. Commands are 
executed starting at the top of the screen. For example, 
Suppose you enter DISCARD on a line. You can then type an equal 
Sign on any other line(s). Those files preceded by egual signs 
are discarded when the EXECUTE command is entered (from the 
command line or by pressing the PF10 key). 


oy) 


means display the last command executed. The command is 
displayed on the line in which the ? is entered. 


/ means make this line the current line. (On the RDRLIST screen, 
the current line is the first file on the screen.) 
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Error Messages and Return Ccdes for EXECUTE 


CMSWEX526E OPTION 'CURSOR* VALID IN DISPLAY MCDE ONLY. RC=3 

DMSWEX561E CURSOR IS NCT ON A VALIT DATA FIELD. RC=3 

CMSWEX651E "EXECUTE MUST EEF ISSUED FROM FILELIST Ck RDRLIST. RC=40 

DMSWEX654E INVALID SYMECL "'symbol'. {'yO* MUST BE SPECIFIED ALONE| 
INVALID CHARACTER ‘char! FCLLOWING ‘/Y* SYMEOL}. RC=24 


On a typewriter terminal only: 
Executing: command 
+++E (nn) +++ 


DISCARD 


Use the DISCARD command tec purge a file displayed in the reader list. 
DISCARD is eguivalent to a RECEIVE command issued with the PURGE option. 
Unlike the CP PURGE command, DISCARD allows an acknowledgment to be sent 
to the sender (if he reguested cne). The acknowledgment indicates that 
the file was discarded. DISCARD also makes an entry in your “userid 
NETLOG" file, which indicates that this file was discarded. A log entry 
is made only if the LOG oftion (the default) is in effect in the RECEIVE 
colmand. (For more infcrmaticn on ackncwledgments and the “userid 
NETLOG" file, see the RECEIVE conmand.) 


DISCARD can either te typed in the command area of the line that 
describes the reader file ycu want furged, or it can be entered from the 
command line (at the bottom of the screen). The format of the DISCARD 
command as used in the RDRLIST environment is: 


ee ee ee 
[DISCARD |[spoolid] J 
I a 


where: 


spoolid is the spoolid cf the reader file to be purged. If DISCARD is 
typed on the line that describes the file to be purged, the 
spoolid is appended automatically. 


Usage Note 


If you want to enter DISCARD from the XEDIT command line, use EXECUTE, 
which automatically appends the speclid. For example, 


EXECUTE 1 DISCARD 
purges the first file displayed in the reader list (the current line). 


EXECUTE automatically appends the spoolid to the command (DISCARD) 
specified. This method is particularly useful on a typewriter terminal. 


Error Nessages and Return Cedes for LISCARLD 


DMSWDC649E EXTRANEOUS PARAMETER ‘parameter®. RC=24 

DMSWDC651E DISCARD MUST BE ISSUED FRCM RDRLIST, PEEK OR FILELIST RC=40 
CMSWDC653E ERROR EXECUTING ‘comgand', RC = on RC=40 

Messages when in FILELIS1I and RDRLIST environments (in XEDIT): 


DMSWDC652E MISSING CPERANDT(S). SPECIFY "EXFCUTE [n] DISCARD! RC=24 
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Examples 
In the RDRLIST environment, information about the user's virtual reader 


is displayed in a format similar to what the FILELIST command provides 
about a CMS mini-disk. 


The following is a sample RDRLIST screen. 


1=Help 2=Refresh 3=Quit 7=Backward 8=Forward 9=Receive 
4=Sort (type) 5=Sort (date) 6=Sort(user) 10=Execute 11=Peek 12=Cursor 
===> 


XEDIT 


| OHARA RDRLIST A1 V 105 TRUNC=105 SIZE=17 LINE=1 COLUMN=1 l 

| 
| Cmd Filename Filetype Class User At Node Hold Records Date Time { 
| PIZZA TOPPINGS PUN A KEN NODEO4 NONE 10 10/06 10:39:38 | 
| COOKIE ASSEMBLE PUN A KEN NODEO4Y NONE 10 10/06 10:25:11 | 
| S$JELLY SCRIPT PRT A KEN NODEO4 NONE 7 10/06 10315350 | 
| DIETING TIPS PUN A KEN NODEOY NONE 11 10/06 09:40:28 | 
l KEN NOTE PUN A KEN NODEOS NONE 10 10/06 08:43:07 | 
| SEND EXEC PUN A BOER NODEO2 NONE 2 10/06 07:12:35 | 
| GOOD DAY PUN A GEOFF NODEO2 NONE 29 10/05 11:44:34 | 
| Acknowl edgment PUN A BOB NODEO2 NONE 2 10/05 11:42:21 | 
| | 
| | 
| | 
I l 
| l 
i I 


Figure 27. Sample RDRLIST Screen 


Examples of Using Symbols 


The following examples show how symbols can be used to represent 
operands in a command. The values substituted for the symbols and the 
resulting command are shown. In each case, the command can be entered 
in either of the following ways: 


e typed in the "Cmd" area of the screen. The command is executed 
either by entering EXECUTE on the XEDIT command line and then 
pressing ENTER, or by pressing PF10. 


e entered from the XEDIT command line, as an operand of EXECUTE (in 
the form "EXECUTE lines command"). 


If a symbol is not specified, the spoolid number of the reader file is 
appended automatically to the command. 


aa a aa a) a aa Aa aaa a a a aa aT | 
| SPOOL FILEID | COMMAND | RESULTING COMMAND | 
--——_—___—-—_—— Ht Fs OOOooO4é{“n-'""’"--rkn a 
|pizza toppings | DISCARD | DISCARD spoolid | 
|} tt 
[cookie assemble | RECEIVE / CAKE |RECEIVE spoolid CAKE | 
| | /t ( REPLACE {ASSEMBLE (REPLACE | 
-———_—__—_ tC nee 
Jken note | PEEK | PEEK spoolid | 
4 O_O 
|jsend exec | FILELIST /n * * |FILELIST SEND * * | 
-—-—________—_—_-———_—_——_—_—-——— EE nario | 
|$jelly script | TRANSFER RDR / | TRANSFER RDR spoolid | 
| | TO * PRT {TO * PRT (prints the file) | 


er ee, ee ee Ce 
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DMSRDC702I :READ filename filetype fn (other information) 


A READ control card has been processed; the designated file is 
being written on disk. 


DMSRDC702I READ CONTROL CARD IS MISSING. FOLLOWING ASSUMED: 
DMSRDC702I :READ REALCCARD CHSUT1 Al 


The first card in the deck is not a READ control card. Therefore, 
the file READCARD CMSUT1 Al is created. 


DMSRDC738I RECORD LENGTH IS ‘nnn* BYTES 


The records being read are not 80 bytes long; this message gives 
the length. 


DMSRDCOO8E DEVICE ‘cuu' {INVALID OR NONEXISTENT|UNSUPPORTED DEVICE TYPE} 
RC=36 

DMSRDCO37E DISK 'mode' IS READ/ONLY RC=36 

DASRDCO42E NO FILEID SPECIFIED RC=24 

DMSRDCO5S4E INCOMPLETE FILEID SPECIFIED RC=24 

DMSRDCO62E INVALID * IN FILEID RC=20 

DMSRDCO69E DISK ‘mode NOT ACCESSED RC=36 

DMSRDC105S ERROR 'nn' WRITING FILE ‘fn ft fm* ON DISK RC=100 

DMSRDC124S ERROR READING CARD FILE RC=100 

DMSRDC205W READER EMFTY OR NOT READY RC=8 
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RECEIVE 


Use the RECEIVE EXEC procedure to read onto disk one of the files or 
notes that is in your virtual reader. In most cases these files were 
sent to you by other computer users, on your computer or on other 
computers that are connected to yours via the Remote Spooling 
Communications Subsystem (RSCS) network. 


The format of the RECEIVE command is: 


[RECEIVE | [spoolid [fn [ft [fm J] [ (options...[) ]]]] | 
| { 
| options: i 
| [NOTebook fn{[NOTebook *] l 
| [ Log | NOLog] i 
| { Purge] | 
| [ Replace ] i 
| [ Qlddate | NEwdate] l 
| [ STack ] | 
Be | 


_——— eee ee fee ee eee 


where: 


spoolid specifies which file in the virtual reader is to be received. 
The default is '="' or 'next' which means the 'next' file in 
the reader 1S received. 


The 'next" file is the one for which the RDR command returns 
information. Which file this is depends on the class of the 
reader, the class of the files in the reader, and whether or 
not they are held. 


fn is the filename the file is to be given. The default is =, 
which means the file's present name is used. 


ft is the filetype the file is to be given. The default is =, 
which means the file's present tyre is used. 


fu is the filemode the file is to be given. If not specified, 
the default is "A". 


If the file being received is a note (prepared by the NOTE command), or 
if the PURGE option is specified, the operands fn, ft, and fm are 
ignored. If the file being received is an acknowledgment, all 
parameters and all options (except the spoolid and the PURGE option) are 
ignored. (See the usage note, "Acknowledgments", for more information 
on acknowledgments.) 


Options: 


NOTebook fn causes the file to be saved as a note in a file named "fn 
NOTEBOOK." You can use this option if you want’ the 
note (s) from this person to be kept in a separate file. 
If you do not specify a notebook filename here, a 
filename is first searched for in the sender's entry in 
your "userid NAMES" file and then in a file set up by the 
DEFAULTS command. If neither contains a notebook 
filename, the note is saved in the default notebook file, 
"ALL NOTEBOOK". A note is saved by appending it to the 
NOTEBOOK file, with a line of 73 equal signs (=) 
separating each note. 
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If the file is not a note (prepared by the NOTE command), 
this option is ignored. 


See the NAMEFIND or NAMES command description for more 
information on the relationship between a "userid NAMES" 
file and the NOTEBOOK file. 


NOTebook * specifies that note is saved in a file named "name 


Log 


NOLOg 


Purge 


Repla 


Oldda 


NOTEBOOK", where "name" is the value of the Notebook tag 
in the sender's entry in your "userid NAMES" file, or the 
sender's nickname, or the sender's userid (whichever is 
located first). 


If the file is not a note (prepared by the NOTE command), 
this option is ignored. 


specifies that the recipients, date, and time of this 
file transmission are logged ina file called “userid 
NETLOG", This log is updated when acknowledgments of 
sent files are received (if they were reguested). Do not 
use this option if you have no read/write disk accessed. 


specifies that this file transmission is not to be 
logged. 


specifies that this file is to be purged and not read 
onto disk. 


ce specifies that if a file of the same filename, filetype 
and filemode exists, it is to be replaced with this one. 
Without this option, the file will not be read onto disk 
if it would overlay an existing file. 


If the file being received is a NOTE file, REPLACE is 
ignored. 


te means that when a file that was sent in NETDATA or DISK 
DUMP format is received, it is written to disk with its 
original date and time (that is, the date and time it was 
created or last updated by the sender), not the date and 
time you received it. For more information on NETDATA 
format, see the SENDFILE command, the usage note "Format 
of the File Sent by SENDFILE". 


NEwdate means to re-date the file to the current date and time it 


STack 


is received. 


specifies that the message returned when RECEIVE 
completes successfully should be stacked (LIFO). If this 
option is not specified, the messages from RECEIVE are 
displayed at the terminal. 


Usage Notes: 


1. 
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Tailoring the RECEIVE Command Options 


You can use the DEFAULTS command to set up options and/or override 
command defaults for RECEIVE. However, the options you specify in 
the command line when entering the RECEIVE command override those 


specified in the DEFAULTS command. This allows you to customize 
the defaults of the RECEIVE command, yet override them when you 
desire. Refer to the DEFAULTS command description for more 
information. 
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Why Should I Use Receive? 


You should use RECEIVE instead of READCARD or DISK for general 
purpose use, because RECEIVE calls either READCARD or DISK, 
whichever is appropriate. It also handles notes, acknowledgments, 
etc. In fact, RECEIVE handles most of the various formats of files 
that can appear in your virtual reader. RECEIVE is the only way to 
read a file that was sent using the SENDFILE command issued with 
the NEW option. 


RECEIVE is particularly useful within the RDRLIST command 
environment, where it is assigned to the PF9 key. 


Acknowledgments 


Acknowledgments can be sent to users on different computers 
connected by the RSCS network so that they can be sure that a file 
they sent was received. 


The sender can specify on the SENDFILE or NOTE command that an 
acknowledgment be returned to him when a file is RECEIVEd. The 
SENDFILE command must be issued with the NEW option (the default) 
in order to request an acknowledgment; otherwise, the request is 
ignored. Even if a recipient discards a file (using the DISCARD 
command), an acknowledgment is returned to the sender. This is 
possible because DISCARD is equivalent to a RECEIVE issued with the 
PURGE option. (For more information on DISCARD, see the RDRLIST 
command.) The acknowledgment indicates whether the file was 
received (written to disk) or discarded (purged). 


When you RECEIVE an acknowledgment that appears in your reader, all 
parameters and all options (except the spoolid and the PURGE 
option) are ignored. The acknowledgment is used to make an entry 
in your “userid NETLOG" file. This entry confirms that’ the file 
you sent was received (or discarded). The format of entries in the 
"userid NETLOG" file is shown in the "Examples" section, below. 


Special NETDATA Files from MVS with TSO Extensions (PP) 


The MVS with TSO Extensions Program Product can send an empty file. 
It can also send two files in NETIDATA format in ae_e single 
transmission. Receiving an empty (null) file results in an error 
message that indicates no file was created on disk. Receiving two 
files sent in one transmission results in two messages, identifying 
each file that was received. 


Responses 


File 
spfn' 
File 
File 
Note 
Note 
Ackn 


"fn ft fm' received from "userid' at 'node' sent as ‘'spfn spft 


'fn ft fm' received from ‘userid at ‘node!’ 
'spfn spft' has been discarded. 

'spfn spft' has been discarded. 

"spfn spft' added to 'fn NOTEBOOK fm'* 

added to ‘userid NETLOG® 


Error Messages and Return Codes 


DMSWRCOOQ3SE INVALID OPTION option*. RC=24 

DMSWRCOOGE NO READ/WRITE DISK ACCESSED. RC=36 

DMSWRCO24E FILE ‘fn ft fm" ALREADY EXISTS. RC=28 
DMSWRCO29E INVALID PARAMETER ‘nnnn' IN THE OPTION 'Spoolid' 


FIELD. RC=24 


DMSWRCO37E DISK ‘mode' IS ACCESSED AS READ/ONLY. RC=36 
DMSWRCO62E INVALID CHARACTER '** IN FILEID fn ft fm'. RC=20 


Section 2. CMS Commands 279 


RECEIVE 


DMSWRCO69E DISK 'mode' NOT ACCESSED. RC=36 

DMSWRC630S ERROR ACCESSING SPOOL FILE. RC=36 

DMSWRC637E MISSING VALUE FOR THE [ 'NOTEBOOK"|*SPOOLID! ] OPTION. 
RC=24 

DMSWRC643E NO CLASS ‘class! FILES IN YOUR READER. RC=28 

DMSWRC644E ALL READER FILES ARE IN HOLD STATUS OR NOT CLASS 
'class'. RC=28 

DMSWRC649E EXTRANEOUS PARAMETER ‘value’. RC=24 

DMSWRC655E SPOOLID ‘nnnn' DOES NOT EXIST. RC=28 

DMSWRC671E ERROR RECEIVING FILE 'fn ft fm', RC = nn FROM 
'command'. RC=100 

DMSWRC672E VIRTUAL READER INVALID OR NOT DEFINED. RC=36 

DMSWRC674E READER IS NOT READY. RC=36 

DMSWRC681E THIS IS AN UNNAMED FILE. SPECIFY FILENAME AND 
FILETYPE. kRcC=88 

DMSWRC682E ERROR COPYING FILE ‘fn ft' FROM 'A* DISK TO ‘mode! 
DISK, RC = nn FROM COPYFILE COMMAND. RC=100 

DMSSTTO62E INVALID CHARACTER ‘character! IN FILEID 'fn ft'. RC=20 


Examples 


Format of the "userid NETLOG" File 


The format of entries in the "userid NETLOG" file maintained by SENDFILE 
and RECEIVE is shown below. If both the "ACK" and "LOG" options of 
SENDFILE or NOTE are specified, a "sent to" record is placed in the 
NETLOG file. When an acknowledgment is received, it is also placed in 
this file. 


| | 
{File SMALL DATA A sent to OHARA at NODEO1 on 10/14/80 11:30:25 | 
|File SMALL DATA A recv from CHARA at NODEO1 on 10/14/80 11:30:47 | 
|Jsent as SMALL DATA A | 
JAckn 10/14780 11:30:47 recv by OHARA at NODEO1 on 10/14/80 11:30:25 | 


In this example, the user sent himself a file (SMALL DATA) using 
SENDFILE with the LOG and ACK options specified. The first line in the 
NETLOG file was placed in the file by the SENDFILE command. 


He then used RECEIVE (with the LOG option) to read the file onto disk. 
The second line was added when the file was received. (In this case the 
sender was the receiver.) The "recv" in this line means "received", If 
a file is discarded (using DISCARD), the line contains "disc" instead of 
"recv". This line also indicates the fileid that the file was "sent 
as", (The file can be RECEIVEd with a different fileid than it was sent 
as.) 


Last, he received an acknowledgment. It indicates whether the recipient 
received ("recv") or discarded ("disc") the file. 
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RELEASE 


Use the RELEASE command to free an accessed disk and make the files on 
it unavailable. The format of the RELEASE command is: 


ey a Sp eT eT ee Og ee hee ED Taree RS eg on ee Get ee ea pe Ee ey ee RT Te 


| RELease | cuu [ (DETL) )] | 

l | mode 

Oa i ec eee ee a a i ee 

where: 

cuu is the virtual device address of the disk that is to be 
released. 


Valid addresses are 001 through 5FF for a virtual machine in 
basic control mode and 001 through FFF for a virtual machine 
in extended control node. 


mode is the mode letter at which the disk is currently accessed. 
Option: 
DET specifies that the disk is to be detached from your virtual 


machine configuration; CMS calls the CP command DETACH. 


Usage Notes 
1. 


If a disk is accessed at more than one mode letter, the RELEASE cuu 
command releases all modes. If you access a disk specifying the 
mode letter of an active disk, the first disk is released. 


2. You cannot release the system disk (S-disk). 


3. When a disk is released, the user file directory is freed from 
storage and that storage becomes available for other CMS commands 
and programs. When you release a read/write CMS disk, either with 
the RELEASE command or implicitly with the FORMAT command, the user 
file directory is sorted and rewritten on disk; user(s) who may 
Subsequently access the same disk may have a resultant favorable 
decrease in file search time. 


4. When a disk is released, any read-only extensions it may have are 
not released. The extensions may be referred to by their own mode 
letters. 1f a disk is then accessed with the same mode as the 
Original parent disk, the original read-only extensions remain 
extensions to the new disk at that mode. 


5- In CMS/DOS, when you release a disk, any system or programmer 
logical unit assignments made for the disk are unassigned. 
Responses 
DASD cuu DETACHED 


This is a CP message that is issued when you use the DET option. 
It indicates that the disk has been detached. 
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Error Messages and Return Codes 


DMSAREO17E INVALID DEVICE ADDRESS ‘cuu® RC=24 
DMSAREO28E NO DEVICE SPECIFIED kRC=24 

DMSAREOU4BE INVALID MODE ‘mode* RC=24 

DMSAREO69E DISK {*mode'|'cuu'} NOT ACCESSED RC=36 
DMSAREOQ7VOE INVALID PARAMETER ‘parameter’ RC=24 
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RENAME 


Use the RENAME command to change the fileid of one or more CMS files on 
a read/write CMS disk. The format of the RENAME command is: 


Renane 


fileid1 fileid2 [ (options...[) ]] 


; ; 
| | 
| options: | 
| | 
c | r | | 
r [TYPE | |UPDIRT | | 
| [NOTYEE| |NOUPDIRT| [ 
| L J L J | 


| ee a ee 


where: 
fileid1 is the file identifier of the original file whose name is to 
be changed. All components of the fileid (filename, filetype, 
and filemode) must be coded, with either a name or an 
asterisk. If an asterisk is coded in any field, any file that 
Satisfies the other qualifications is renaned. 
fileid2 is the new file identifier of the file. All components of the 
file (filename, filetype, and filemode) must be coded, with 
either a name or an equal sign; if an equal sign (=) is coded, 
the corresponding file identifier is unchanged. The output 
filemode can also be specified as an asterisk (*), indicating 
that the filemode is not changed. 
Options: 
TYPE displays, at the terminal, the new identifiers of all the 
T files that are renamed. The file identifiers are displayed 
only when an asterisk (*) is specified fcr one or more of the 
file identifiers (fn, ft, or fm) in fileid1. 
NOTYPE 
NOT 
suppresses at the terminal, displaying of the new file 
identifiers of all files renamed. 
UPDIRI 
UP 
updates the master file directory upon completion of this 
command. 
NOUPDIRT 
NOUP 


suppresses the updating of the master file directory upon 
compietion of this command. (See Usage Note 3.) 
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Usage Notes 


1. When you code an asterisk (*) in any portion of the input fileid, 
any or all of the files that satisfy the other qualifiers may be 
renamed, depending upon how you specify the output fileid. For 
example: 


rename * assempble a test file a 


results in the first ASSEMBLE file found on the A-disk being 
renamed to TEST FILE. If more than one ASSEMBLE file exists, error 
messages are issued to indicate that they cannot be renaned. 


If you code an equal sign (=) in an output fileid in a position 
corresponding to an asterisk in an input fileid, all files that 
satisfy the condition are renamed. For example: 


rename * assenble a = oldasn = 


renames all files with a filetype of ASSEMBLE to files with a 
filetype of OLDASM. Current filenames are retained. 


2. You cannot use the RENAME command to move a file from one disk to 
another. You must use the COPYFILE command if you want to change 
filemode letters. 


You can use the RENAME command to modify filemode numbers, for 
example, 


rename * module al = = a2 


changes the filemode number on all MODULE files that have a mode 
number of 1 to a gacde number of 2. ) 


Note: You can invoke the RENAME command from the terminal, from an 
EXEC file, or as a function from a program. If RENAME is invoked as 
a function or from an EXEC file that has the &CONTROL NOMSG option 
in effect, the message DMSRNMOO2E FILE ‘fn ft fm" NOT FOUND is not 
issued. 


3. Normally, the file directory for a CMS disk is updated whenever you 
issue a command that affects files on the disk. When you use the 
NOUPDIRT option of the RENAME command, the file directory is not 
updated until you issue a command that writes, updates, or deletes 
any file on the disk, or until you explicitly release the disk 
(with the RELEASE command). 


Responses 


newfn newft newfn 


The new filename, filetype, and filemode of each file altered is 
displayed when the TYPE ofpticn is specified and an asterisk was 
specified for at least one of the file identifiers (fn, ft or fm) 
of the input fileid. 
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Error Messages and Return Codes 


DMSRNMOOZ2ZE 
DMSRNMOO3E 
DMSRNMO19E 
DMSRNMO24E 
DMSRNMO3OE 
DMSRNMO37E 
DMSRNMOYB8E 
DMSRNMOS1E 
DMSRNMOS4E 
DMSRENMO62E 
DMSRNMO69E 


FILE ‘fn £t fm* NCT FCUND RC=28 
INVALID OPTION *option® RC=24 
IDENTICAL FILEIDS RC=24 

FILE ‘fn ft fm" ALREADY EXISTS RC=28 
FILE "fn ft fm" ALREADY ACTIVE RC=28 
DISK "mode(cuu)' IS READ/ONLY RC=36 
INVALID FILE MODE 'fm' RC=24 

INVALID MCDE CHANGE kRC=24 

INCOMPLETE FILEID SPECIFIED RC=24 
INVALID * IN OUTPUT FILEID RC=20 
DISK ‘mode* NOT ACCESSED RC=36 
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Use the RSERV command in CMSy/DOS to copy, display, print, or punch a VSE 
relocatable module from a frivate or system library. The format of the 
RSERV command is: 


| l r 7 | 
| RSERV | modname | ft | [ (options...[) ]] { 
| ; [| TEXi | | 
| | L 4 options: 
{ | [ DISK] [ PRINT ] | 
| | [PUNCH] [TERM] | 
SRE A on ee 
here: 


nodnane specifies the name of the module on the VSE private or systen 
relocatable litrary. The private library, if any, is searched 
before the system library. 


ft Specifies the filetype of the file to be created on your 


A-disk. ft defaults to TEXT if a filetype is not specified. 
The filename is always the same as the module name. 


Options: You may specify aS many options aS you wish on the RSERV 
command, depending on which functions you want to perforn. 


DISK copies the relocatable module onto your A-disk. If no other 
options are specified, DISK is the default. 


PUNCH punches the relocatable module on the virtual punch. 
PRINT prints the relocatable nodule on the virtual printer. 


TERM displays the relocatakle moduie at your terminal. 


Usage Notes 


1. If you want to copy modules from a private relocatable library, you 
must issue an ASSGN command for the logical unit SYSRLB_ and 
identify the library on a DIBL command line uSing the ddnane 
IJSYSRL. 


To copy modules from the system relocatable library, you must have 
entered the CMS/DOS environment specifying a mode letter on the SET 
DOS ON command line. 


2. The RSERV command ignores the assignment of logical units, and 
directs output to the devices specified on the cption list. 
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Responses 


If you use 
terminal. 


the TERM option, the relocatable module is 


Messages and Return Codes 


DMSRRVOO3E 
DMSRRVOOWE 
DMSRRVOOG6E 
DMSRRVO7OE 
DMSRRVOYTE 
DMSRRVOJSE 
DMSRRVO9IE 
DMSRRV105S 
DMSRRV1135S 
DMSRRV4115S 


INVALID CPTION ‘option’ RC=24 

MODULE ‘module' NOT FOUND RC=28 

NO READ/WRITE "A* DISK ACCESSED RC=36 
INVALID PARAMETER ‘parameter' RC=24 

NO "SYSRES* VOLUME ACTIVE RC=36 

NO MODULE NAME SFECIFIED RC=24 

CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 
ERROR ‘nn! WRITING FILE ‘fn ft £m*' ON DISK 
DISK (cuu) NOT ATTACHED RC=100 

INPUT ERROR CODE ‘nn ON * {SYSRES| SYSRLB} '°* 
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RUN 


Use the RUN EXEC procedure to initiate a series of functions on a file 
depending on the filetype. The RUN command can select or combine the 
procedures required to compile, load, or start execution of the 
specified file. The format of the RUN command is: 


Wc eg Oe ee EY ee NL GG Sg ee ee nee de ae —emeng ee OE RTs OG ge ee NI ee ng et eee 
[| RUN | fn [ft [fm]}] [ (args..-[) J] | 
Se EE ee 
where: 

fn is the filename of the file to be manipulated. 

ft is the filetype of the file to be manipulated. If filetype is 


not specified, a search is made for a file with the specified 
filename and the filetype of EXEC, MODULE, or TEXT (the search 
is performed in that order). If the filetype of an input file 
for a language processor is specified, the language processor 
is invoked to compile the source statements and produce a TEXT 
file. If no compilation errors are found, LOAD and START may 
then be called to initiate program execution. The valid 
filetypes and resulting action for this command are: 


Filetype Action 
EXEC The EXEC processor is called to process the file. 


MODULE The LOADMOD command is issued to load the program into 
storage and the START command begins execution of the 
program at the entry point equal to fn. 


TEXT The LOAD command brings the file into storage in an 
executable format and the START command executes’ the 
program beginning at the entry point named by fn. 


FORTRAN The FORTRAN processor module that is called is FORTRAN, 
FORTGI, GOFORT, or FORTHX, whichever is found first. 
Object text successfully compiled by the FORTGI or FORTHX 
processors will be loaded and executed. 


TESTPORT The TESTFORT module is called to initiate FORTRAN 
Interactive Debug and will process a TEXT file that has 
been compiled with the TEST option. 


FREEFORT The GOFORT module is called to process the file. 


COBOL The COBOL frocessor module that is called is COBOL or 
TESTCOB, whichever is found first. After successful 
compilation, the program text will be loaded and 
executed. 
PLI The PLIOPT processor module is called to process 
PLIOPT the file. After successful compilation, the program text 
will be loaded and executed. 
fn is the filemode of the file to be manipulated. If this field 
is specified, a filetype must be specified. If fmis_ not 
specified, the default search order is used to search your : ) 


disks for the file. 
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are arguments you want to pass to your program. You can 
specify up to 13 arguments in the RUN command, provided they 
fit on a single input line. Each argument is left-—justified, 
and any argument more than eight characters long is truncated 
from the right. 


The RUN command is an EXEC file; if you want to execute it fron 
within an EXEC, you must use the EXEC command. 


2. If you are executing an EXEC file, the arguments you enter on the 
RUN command line are assigned to the variable symbols 6&1, &2, and 
so on. 

3. If you are executing a TEXT or MODULE file, or compiling and 
executing a program, the arguments are placed in a parameter list 
and passed to your program when it executes. The arguments are 
placed in a series of doublewords in storage, terminated by X'FF*. 
If you enter: 

run myprog (charlie dog 
the arguments *, CHARLIE, and DOG are placed in doublewords in a 
parameter list, and the address of the list is in register 1 when 
your program receives control. 
Note: You cannot use the argument list to override default options 
for the compilers or for the LOAD or START commands. 

4. The RUN command is not designed for use with CMNS/DOS. 

5- The RUN EXEC cannot te used for COBOL and PL/I programs that 
require facilities nct supforted under CMS. For specific language 
support limitations, see VM/SP Planning and System Generation 
Guide. 

Responses 


Any responses are from the programs or procedures that executed within 
the RUN EXEC. 


Error Messages and Return Codes 


DMSRUNOO1E NO FILENAME SPECIFIED RC=24 
DMSRUNOOZE FILEL[ 'fn [ft [f£m]]"] NOT FCUND RC=28 
DMSRUNOSSE INVALID MODE 'fm*' RC=24 

DMSRUNO7OE INVALID ARGUMENT ‘argument' RC=24 
DMSRUNSOSE NO [ft] MODULE FOUND RkC=28 
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Use the SENDFILE EXEC procedure to send files or notes to one or more 
computer users on your cogputer or on other computers that are connected 
to yours via the Remote Spooling Communications Subsystem (RSCS) 
network. 


SENDFILE is one of several commands that references a “userid NAMES" 
file. By setting up a names file, you can identify recipients just by 
using nicknames, which are automatically converted into node and userid. 
For information on creating a names file, see the NAMES command. 


The format of the SENDFILE command is: 


|ISENDFile | [fn ft [fm] [[ TO] name...] [ (options...[) ]]] | 
| SFile | ( 
| | options: | 
| | [Ack | NCAck] r 
| [Filelist |] NOFilelist ] { 
| I { Log | NOLog] ( 
| | [ NEw | Old] | 
l | [NOTE] l 
| { [ Type | NOType] | 
| oe 

where: 

fn is the filename of the file to be sent. 

ft is the filetype of the file to be sent. 

fn is the filemode of the file to be sent. If "*" is specified 


(the default), all accessed disks are searched, and the first 
file found is sent. This operand can be omitted if the first 
"name" would not be misinterpreted as a filemode, or if the 
keyword "TO" is used. 


TO is a keyword operand. It can be omitted if the first "name" is 
not "TO". 
name is one or nore "names" of the computer users to whom the file 


is to be sent. If the same recipient iS specified more than 
once, he receives only one copy of the file. The "name" may 
take any of the following forms, and the different forms can be 
freely intermixed: 


e a "nickname" that can be found in the file "userid NAMES", 
where "userid" is your userid. This nickname may represent 
a Single person (on your computer or on another computer), 
or a list of several people. See the NAMES command for nore 
information on nicknames. 


e aouserid of a computer user on your computer. If a name 
cannot be found in the “userid NAMES" file, it is assumed to 
be a userid of somecne on your computer. 


e "userid AT node", which identifies a user ("userid") on your 
computer or another computer ("node"). 


You cannot send files to a userid named "AT" or "CCCs", 
If no operands are specified, a menu is displayed. This menu is 


described in the Usage Note below, “Using the SENDFILE Menu". 
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NOAck 


Filelist 


NOFilelist 


Log 


NOLog 


NEw 


Old 


NOTE 


Type 


NOTy pe 


SENDFILE 


requests. an acknowledgment be returned to you and logged 
when the recipient receives your file (using the RECEIVE 
command). Acknowledgments are added to your "userid 
NETLOG" file. An acknowledgment is sent only if the NEW 
option is also in effect. 


requests that no acknowledgment be returned when the 
recipient RECEIVES a file. 


Specifies that the file (fn £t fm) is a list of files in 
the format of a CMS EXEC file produced by the LISTFILE 
command issued with the EXEC option, or a file saved fron 
a FILELIST command. This option is used to send nultiple 
files with only one invocation of SENDFILE. Both the 
file containing the list of files and each file in the 
list are sent. 


Lines beginning with an asterisk (*) and blank lines are 
ignored. All EXEC tokens (for example, &1, &2) or any 
token beginning with an ampersand (&) is ignored. 


For information on creating a list of files that can be 
saved and used to send multiple files, see the FILELIST 
command, the usage note "Saving a List of Files". 


specifies that the file is not a list of files. 


specifies that the recipients, date, and time of this 
file transmission are logged ina file called "userid 
NETLOG". This log is updated when acknowledgments of 
sent files are received (if they were requested). Do not 
use this option if you have no read/write disk accessed. 


specifies that this file transmission is not to be 
logged. 


specifies that header records are added and the file is 
sent as described below, in "Format of the File Sent by 
SENDFILE". If this option is specified, the recipient 
must use RECEIVE to read the file. 


specifies that the file is sent using DISK DUMP. This 
option should be specified when the recipient of the file 
does not have the RECEIVE command available to read the 
file. When OLD is specified, no acknowledgment (the ACK 
option) can ke requested. 


specifies that the file is to be sent as a note (that was 
prepared using the NOTE command). The "TO" operand and 
the list of names cannot be specified if this option is 
given. If no file is specified, the file "userid NOTE *" 
is sent as a note. (On a display terminal, the PF5 key 
is set to this oftion in the NOTE command environment.) 


specifies that the files sent and the userids and nodes 
to which the files were sent are displayed at the 
terminal. 


specifies that no information is to be displayed. 
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Tailoring the SENDFILE Command Options 


You can use the DEFAULIS command to set up options and/or override 
command defaults for SENDFILE. However, the options you specify in 
the command line when entering the SENDFILE command override those 


specified in the DEFAULTS command. This allows you to customize 
the defaults of the SENDFILE command, yet override them when you 
desire. Refer to the DEFAULTS command description for nore 
information. 


Using the SENDFILE Menu (Display Terminals Only) 


Enter the SENDFILE command without operands to display a menu, on 
which you "fill in the blanks" with the necessary information. A 
Sample SENDFILE menu is shown in the "Examples", below. 


The File Identifier 


You type the filename, filetype, and filemode of a file that you 
want to send directly on the menu in the spaces provided. If you 
do not enter a filemode, the default is "A". 


If you want to select the files froma list, you can type an 
asterisk (*) for filename, filetype, and/or filemode. An asterisk 
means that you want the list to contain all filenames (or 
filetypes, or filemodes). 


You can also use two special characters in the filename and/or 
filetype to request that the list contain a specific subset of 
files. The special characters are * (asterisk) and % (percent), 
where: 


* represents any number of character(s). AS Many asterisks as 
required can appear anywhere in a filename or filetype. 


2 means any Single character, but any character will do. As 
Many percent symbols as necessary May appear anywhere ina 
filename or filetype. 


To display the list, first finish filling out the menu, and then 
press either PF5 or PF10. A special FILELIST screen is displayed 
instead of the SENDFILE menu. You select the files by typing a 
letter "s" in front of the filename of each file to be sent. Then 
press the PF10 key to send the files. 


Another way to select files to be sent from the FILELIST screen is 
to position the cursor on the line describing a file you want to 
send, and then press PF5. 


The Recipient (s) 


You type the name(s) of the recipient(s) in the space provided. A 
name can take any of the forms listed above, in the "name" operand 
description. 


The Options 


A list of options also appears on the menu. The default for each 
option appears to its left. You type YES or NO over any options 
for which you do not want the default. (If you type NO over YES, 
press the space bar, because NOS is not recognized.) The options 
are as follows: 
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NO Request acknowledgment when the file has been received? 


Type YES only if you want to get an acknowledgment when the 
person receives your file. The acknowledgment shows’ the date 
and time the file was received, and the recipient's userid and 
node. 


When you get an acknowledgment, it appears in your reader. If 
you choose to receive it, an entry is made in a “userid NETLOG" 
file, which is explained below. 


YES Make a log entry when the file has been sent? 


Each time you send a file, an entry is automatically made in 
the file "userid NETLOG". A typical entry might look like 
this: 


File MY DATA Ail sent to JONES at NODE1 on 10/10/81 11:30:25 EDT 


If you specified YES on the first option (acknowledgment), an 
entry is also made when you receive the acknowledgment. 


Type NO if you don't want an entry made in the log file. 
YES Display the file name when the file has been sent? 


The names of the file(s) and the userid(s) and node(s) of the 
recipients are displayed on a cleared screen. Type NO if you 
do not want this information displayed. 


NO This file is actually a list of files to be sent? 


see the FILELIST command, the usage note "Saving a List of 
Files", for information on saving a file list. By saving a 
list of files created by either the FILELIST command or the 
LISTFILE command issued with the EXEC option, you can send all 
the files (and the list of files) at once. Type YES if your 
file is a list of files. 


sending a File 


If you specified only one fileid, press either PF5 or PF10 after 
filling out the SENIFILE menu. PF5 sends the file and exits fron 
the menu. PF10 sends the file but keeps the menu. 


If you are selecting files from a FILELIST screen type a letter "s" 
in front of each filename you want to send. Then press PF10 to 
send the file(s). 


PF Keys on the SENDFILE Menu 


PF 1 Help Display information about the SENDFILE command. 
PF 2 Not assigned. 
PF 3 Quit Exit from the menu. 
PF 4 Not assigned 
PF 5 Execute and Quit 
Send the file(s) and exit from the screen. 
PF 6 , Not assigned 
PF 7 Not assigned 
PF 8 Not assigned 
PF 9 Not assigned 
PF 10 Execute Send the file. 
PF 11 Not assigned 
PF 12 Cursor Put cursor in “Enter filenamne:" field 


Section 2. CMS Commands 293 


SENDFILE 


294 


Note: On a terminal equipped with 24 PF keys, PF keys 13 to 24 are 


assigned the same values as PF keys 1 to 12 as discussed here. , ) 

PF Keys on the FILFLISI Screen 

PF 1 Help Display information about the FILELIST command. 

PF 2 Refresh Update the list to indicate new files, 
erased files, etc., using the same parameters 
as those specified on the SENDFILE panel. 

PF 3 Quit Exit from the list. 

PF 4 Sort files by filetype, filename. 

PF 5 Sendfile at cursor. Append the fn ft fm on this line and 
send the file. 

PF 6 Sort files by size, largest first. 

PF 7 Backward Scroll backward one screen. 

PF 8 Forward Scroll forward one screen. 

PF 9 FL/n Issue the command FILELIST /n * * at the cursor, 
so that a list is displayed, containing 
all files that have the filename that is 
displayed on the line with the cursor. 

PF 10 Execute Execute command(s) typed on display or on command 
line. 

PF 11 XEDIT Edit the file pointed to by the cursor. 

PF 12 Cursor Move cursor to current column in current line. 

An example of a SENDFILE menu and a FILELIST screen are shown in 


the "Examples" section, below. 


Format of the File Sent by SENDFILE 


The format of the 


file that is sent depends on whether the OLD or 


NEW (the default) option is specified. 


Important note; 
command is the only way you can read a file sent by SENDFILE. 


The OLD Option 


Unless the OLD option is specified, the RECEIVE 2 


If the OLD option is specified, DISK DUMP is used to send the file. 


The OLD 
RECEIVE 


The NEW 


If the NEW 


option 


should be used if the recipient does not have the 


command available to read the file. 


Option 


option is specified, control records are added and the 


file is sent in a format called "NETDATA". 


The 


transmitted file is composed of several control records, 


followed by the data records, and ending with a trailer record. If 
the file is an acknowledgment, it consists only of control records. 
An acknowledgment can be requested only with the NEW option. 


The NEW option should be used when the recipient can read the file 


with the 


RECEIVE command on his CMS system, or when the file is 


being sent to the MVS operating system with TSO extensions Progran 
Product. 


Priority 


When SENDFILE is issued to send a file across the network (to a node 
different from yours), the file is assigned a priority. The order 


and speed 
size of the file. 


of transmission are based on both this priority and the } 


The priorities are assigned as follows: 
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NOTES approximately 100 records in size: Priority = 00 (high) 
Other files: Priority = 50 (medium) 
Acknowledgments: Priority = 90 (low) 


Responses 


Body of the note kept in 'fn NOTEBOOK fm' 
Header only added to other NOTEBOOK files. 
File|Note 'fn fm ft' sent to ‘userid’ at 'node' on ‘date time timezone! 
'nnn' FILES HAVE BEEN SENT. 
File 'fn ft fm' not found. 


NOTE added 


The following message appears on the FILELIST screen invoked from 


to "fn NOTEBOOK fm! 


SFEFNDFILE menu: 


Type 'S* in front of each file to be sent, and press pf10. 


Error Messages and Return Codes 


DMSWSFOO2E 
DMSWSFOO3E 
DMSWSFOO6E 
DMSWSFOSUE 
DMSWSFO62E 
DMSWSFO69E 
DMSWSF637E 
DMSWSF647E 


DMSWSF648E 
DMSWSF667E 
DMSWSF671E 


DMSWSF672E 
DMSWSF673E 


DMSWSFO674E 
DMSWSF675E 
DMSWSF676E 
DMSWSF677E 
DMSWSF678E 


DMSWSF679E 


DMSSTTOY8E 
DMSSTTO62E 


FILE 'fn ft fm*' NOT FOUND. RC=28 

INVALID OPTION ‘option. RC=24 

NO READ/WRITE DISK ACCESSED. RC=36 
INCOMPLETE FILEID SPECIFIED. RC=24 
INVALID CHARACTER *** IN FILEID 'fn £t fm'*. 
DISK 'modet NOT ACCESSED. RC=36 

MISSING NODEID FOR THE AT OPERAND. RC=24 
USERID NOT SPECIFIED FOR 'nickname! IN 'Userid NAMES'® 
FILF. RC=32 

USERID 'name* NOT FOUND. 
RC=32 

NOTE HEADER DOES NOT CONTAIN THE {keyword 
"FROM'|keyword ' TO: "| *OPTIONS! line}. RC=32 

ERROR SENDING FILE "fn £t fm', RC = nn FROM ‘command’. 
RC=100 

VIRTUAL PUNCH INVALID OR NOT DEFINED. RC=36 
ADDRESSEES ARE IN THE NOTE HEADER CARDS, DO NOT 
SPECIFY NAMES WITH NCTE OPTION. RC=24 
PUNCH IS NOT READY. RC=36 

NO NAMES SPECIFIED. RC=24 

INVALID CHARACTER *** FOR NETWORK ID. 
INVALID OPTION ‘toption! IN OPTION LINE. 
INVALID NOTE HEADER FORMAT. 
RC=32 

{Disk 'mode't IS READ/ONLY|DISK ‘mode! IS FULL}. 
NOTE CANNOT BE SENT. RC=36 

INVALID MODE ‘'mode'. RC=24 

INVALID CHARACTER 'character' IN FILEID ‘fn ft'*. 
RC=20 


RC=20 


NO FILES HAVE BEEN SENT. 


RC=20 
RC=32 
NOTE CANNOT BE SENT. 


Messages from the SENDFILE Panel: 


DMSWSFO02E 
DMSWSFO4S8E 
DMSWSFOSUE 
DMSWSFO69E 
DMSWSFO81E 
DMSWSF637E 
DMSWSF647E 
DMSWSF648E 
DMSWSF657E 
DMSWSF675E 
DMSWSF680E 


FILE "fn £t f£m* NOT FOUND. 

INVALID MODE ‘mode’. 

INCOMPLETE FILEID SPECIFIED. 

DISK 'modet NOT ACCESSED. 

INVALID REPLY -—- ANSWER "YES" OR "NO", 

MISSING NODEID FOR THE AT OPERAND. 

USERID NOT SPECIFIED FOR 'nickname' IN 'Userid NAMES'* 
USERID 'name* NOT FOUND. NO FILES HAVE BEEN SENT. 
UNDEFINED PFkey. 

NO NAMES SPECIFIED. 

INVALID FILEID SPECIFIED WITH "'FILELIST! OPTION. 
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Examples 
The following is a sample SENDFILE menu: 


: 
~--------------- SENDFILE ~---------------- 


File(s) to be sent (use * for Filename, Filetype and/or Filemode 
to select from a list of files) 

x 

data 

a 


Enter filename 
filetype 
filemode 


Send files to : sleepy 

Type over YES or NO to change the options: 
NO Reguest acknowledgement when the file has been received? 
YES Make a log entry when the file has been sent? 
YES Display the file name when the file has been sent? 


NO This file is actually a list of files to be sent? 


| 
| 
{ 
| 
| 
| 
| 
| 
| 
l 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
Help 3= Quit 5= Execute and Quit 10= Execute 12= Cursor | 
| 
| 


I I 


MACRO-READ 1 FILE 
a a ee 


Figure 28. Sample SENDFILE Menu 


In Figure 28., the sender typed an asterisk for filename, "data" for 
filetype, and "a" for filemode. The name of the recipient (sleepy) is 
also typed on the screen. When PF5 (or PF10) is pressed, a special 
FILELIST screen is displayed. The files to be sent can be selected from 
this screen (shown in Figure 29.). 


a 
SNOWHITE FILELIST A1 V 105 TRUNC=105 SIZE=418 LINE=1 COLUMN=1 
Type 'S*' in front of each file to ke sent, and press pf10. 


Cmd Filename Filetype Fm Format Lrecl Records Blocks Date Time 


i 

| 

| 

| WISTFUL DATA A1l V 95 34 2 10/04/80 21:12:04] 
| s BOSS DATA A1 Vv 95 29 2 10/04/80 20:58:07] 
{ DUMMY DATA A1 V 107 281 10 10/04/80 17:59:00] 
| s GROUCHY DATA A1 Vv 92 101 4 10/02/80 15:33:05] 
| PRINCE DATA A2 V 75 28 1 9/25780 12:10:03| 
i s SNOOZY DATA A2 V 120 277 10 9/24/80 9:14:02| 
| SNIFFLES DATA A1 V 26 7 1 9723780 16:50:06 
| WITCH DATA A1 V 80 489 30 8/26/80 16:05:08 
| 1=Help 2=Refresh 3=Quit 7=Backward 8=Forward 9=FL/n =| 
| 4=Sort(type) 5=Sendfile 6=Sort(size) 10=Execute 11=XEDIT 12=Cursor | 
{ ===> | 
| l 
| 


a a i a a a ae eee ee 
Figure 29. Sample FILELIST Screen Invoked from SENDFILE 


To send one or more of these files, you can type a letter "s" in front 
of the filename of each file you want sent (see above) and then press 
the PF10 key. You can also position the cursor on the line describing 
the file you want to send, and then press the PF5 key. 


296 IBM VM/SP CMS Command and Macro Reference 


SENTRIES 


SENTRIES 


¢ 


Use the SENTRIES command to determine the number of lines currently in 
the program stack. When you issue a SENTRIES command, CHS returns the 
number of lines in the frogram stack (but not the console input buffer) 
as a return code. The format of the SENTRIES command is: 


Wp ee ee ee i ee ee ee ga eal 
| SENTRIES | l 
re 


Usage Notes 


If you issue a SENTRIES command in an EXEC that has the SERROR statement 
in effect, a nonzero SENTRIES return code causes the SERROR statement to 
execute. 
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Use the SET command to establish, turn off, or reset a particular 
function in your CMS virtual machine. Only one function may be 
specified per SET command. The format of the SET command is: 


SS SSS SS 
| SET | function | 
{ | r 1 r 7 l 
l | functions: |BLIP string[ (ccunt) ]] [IRDYMNSG LMSG| f 
i | {BLIP ON JRDYMSG SMSG| | 
| | [BLIP OFF | t 4 | 
( ; : [ 
j [ c 1 r r 101 I 
r | [LDRTBLS nn] | RELPAGE CN | JINPUT | a xx] | 
| | |RELPAGE OFF | | {xx yyl | | 
| | L 4 L L go i 
| | [OUTPUT [xx a] ] | 
| lr 1 r 1 c 1 l 
| | [ABBREV ON | [REDTYPE ON | {J IMPEX ON | l 
l | | ABBREV OFF | [RELTYPE OFFI [IMPEX OFF | | 
| jo 4 L J L 4 | 
l lr 1 r 1 r 7 l 
| | [IMPCP ON | [PROTECT ON | JAUTOREAD ON | l 
| | JIMPCP OFF | {PROTECT OFF | JAUTOREAD OFF| | 
i joe 4 L 4 L 4 i 
; [ l 
| i rer CMSDOS 1 rc CMSDOS 71 | 
| {| JSYSNAME \CMSVSAM/ entrynanme | | NONSHARE \CMSVSAM/ | | 
| 1 | CMSAMS i 4 CMSAMS > | | 
I CMSSEG 1 | CMSSEG \ | r 
| } & CMSBAM J L CMSBAM 4 | 
( i | 
l I rc 1 ; 
| | | CMSTYPE eet ; 
| i | RTf | ; 
I iis 4 l 
I | ( 
l | CMS/DOS functions: | 
| lr 1 1 | 
| | [DOS ON [mode [ (VSAM[) ]]]| |DOSLNCNT no] | 
| | |DOS OFF ; ot 4 | 
| | 4 l 
l { | 
l lr 16 1 l 
| {| {UPSI nnnnonon| |} DCSPART nnnnk]j | 
| | |UPSI OFF {| |DOSPART OFF | | 
jou Jou J | 

eee 


IF. 
i 
Io 
ee 


functions: 


ETE SINR ERED 


BLIP string[ (count) } 
defines the characters that are displayed at the terminal to 
indicate every two seconds of virtual interval timer time. 
This time is made up of virtual processor time plus, if the 
REALTIMER option is in effect, self-imposed wait time. Blips 
may also be caused by the execution of the STIMER macro. 
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You can define up to eight characters as a blip string; if you 
want trailing blanks, you must specify count. ON and OFF must 
not be used as BLIP characters. 


BLIP ON sets the BLIP character string to its default, which is a 
string of nonprintable characters. ON is the default for 
typewriter devices. The default BLIP character provides no 
visual or audio-visual signal on a 3767 terminal. You must 
define a BLIP character fora 3767 if you want the BLIP 
function. 


BLIP OFF turns off BLIP. OFF is the default for graphics devices. 


Note: The BLIP operand will be ignored when issued from the 
CMS batch machine. 


RDYMSG LMSG 
indicates that the standard CMS ready message, including 
current and elapsed time, is used. The format of the standard 
Ready message is: 


R; T=s.nn/s.nm hh:mp:ss 


where the virtual processor time, real processor time, and 
clock time are listed. 


RDYMSG SMSG 
indicates that a shortened form of the CMS ready message (R;) 
which does not include the time is used. 


LDRIBLS nn 

defines the number (nn) of pages of storage to be used for 
loader tables. To successfully set the size of the loader 
tables, the SET LDRTBLS command must be issued immediately 
after IPL. By default, a virtual machine having up to 384K of 
addressable real storage has two pages of loader tables; a 
larger virtual machine has three pages. Each loader table 
page has a capacity of 204 external names. During LOAD and 
INCLUDE command processing, each unigue external nane 
encountered in a TEXT deck is entered in the loader table. 
The LOAD command clears the table before reading TEXT files; 
INCLUDE does not. This number can be changed with the SET 
LDRTBLS nn command provided that: (1) nn is a decimal number 
between 0 and 128, and (2) the virtual machine has’ enough 
Storage available to allcw nn pages to be used for loader 
tables. If these two conditions are met, nn pages are set 
aside for loader tables. If you plan to change the number of 
pages allocated for loader tables, you should deallocate 
storage at the high end of storage so that the storage for the 
loader tables may be obtained from that area. Usually, you 
can deallocate storage by releasing one or more of the disks 
that were accessed. 


releases page frames of storage and sets them to binary zeros 
after the following commands complete execution: ASSEMBLE, 
COPYFILE, COMPARE, EDIT, MACLIB, SORT, TXTLIB, UPDATE, HELP, 
and the program product language processors supported by 
VM/SP. These processors are listed in the VM/SP Introduction. 


RELPAGE OFF 
does not release pages of storage after the commands listed in 
the RELPAGE ON description complete execution. Use the SET 
RELPAGE OFF function when debugging or analyzing a rfroblem so 
that the storage used is not released and can be examined. 
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INPUT a xx 
translates’ the specified character a to the specified 
hexadecimal code xx for characters entered from the terminal. 


INPUT xx yy 
allows you to reset the hexadecimal code xx to the specified 
hexadecimal code yy in your translate table. 


Notes If you issue SET INPUT and SET OUTPUT commands for the 
Same characters, issue the SET OUTPUT command first. 


INPUT returns all characters to their default translation. 


OUTPUT xx a 
translates the specified hexadecinal representation xx to the 
specified character "a" for all xx characters displayed at the 
terminal. 


OUTPUT returns all characters to their default translation. 


Note: Output translaticn does not occur for SCRIPT files when 
the SCRIPI command output is directed to the terminal, nor 
when you use the CMS editor on a display terminal in display 
mode. 


ABBREV ON 
accepts system and user akkreviations for system commands. The 
SYNONYM command makes the system and user abbreviations 
available. 


ABBREV OFF 
accepts only the full system command name or the full user 
Synonym (if one is availakle) for system commands. 


For a discussion of the relationship of the SET ABBREV and 
SYNONYM commands, refer to the SYNONYM command description. 


REDTYPE ON 
types CMS error messages in red for certain terminals equipped 
with the appropriate terminal feature and a two-color ribbon. 
Supported terMinals are described in the VM/SP Terminal User's 


Guide. 

REITYPE OFF f 
Suppresses red typing of error messages. 

IMPEX ON 
treats EXEC files as commands; an EXEC file is invoked when 
the filename of the EXEC file is entered. 

IMPEX OFF 
does not consider EXEC files as commands. You must issue the 
EXEC command to execute an EXEC file. 

ZHPCP ON 
passes command names that CMS does not recognize to CP; that 
is, unknown commands are considered to be CP commands. 

IMPCP OFF 


generates an error message at the terminal if a command is not 
recognized by CuMS. 


PROTECT ON 


protects the CMS nucleus against writing in its storage area. 
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PROTECT OFF 
does not protect the storage area containing the CMS nucleus. 


AUTOREAD ON 
specifies that a console read is to be issued immediately 
after command execution. ON is the default for nondisplay, 
nonbuffered terminals. 


AUTOREAD OFF 
specifies that you do not want a console read to be issued 
until you press the Enter key or its equivalent. OFF is the 
default for display terminals because the display terminal 
does not lock, even when there is no READ active for it. 


Note; If you disconnect from one type of terminal and 
reconnect on another type, the AUTOKEAD status remains 
unchanged. 


CMSDOS 
CMSVSAM 
SYSNAME <CMSAMS entryzbane 

CMSSEG 

CMSBAM 
allows you to replace a saved system name entry in the 
SYSNAMES table with the name of an alternative, or backup 
system. A separate SEIT SYSNAME command must be issued for 
each name entry to be changed. CMSDOS, CMSVSAM, CMSAMS, and 
CMSSEG are the default nazes assigned to the systems when the 
CMS system is generated. 


CMSDOS 
CMSVSAM 
NONSHARE < CMSAMS 
CMSSEG 
CMSBAM 
specifies that you want your own nonshared copy of a normally 
Shared named systea. 


CMSTYPE HT 
Suppresses CMS terminal display within an EXEC. All CMS 
terminal display from an EXEC, except for CMS error messages 
With a suffix letter of 'S* or 'T*', is suppressed until the 
end of the EXEC file or until a SET CMSTYPE RT command is 
executed. 


CMSTYPE RT 
resumes CMS terminal disfrlay which has been suppressed aSa 
result of a previous SET CMSTYPE HT command. 


Note: &STACK HT and SETI CMSTIYPE HT have the same effect when interpreted 
by the CMS EXEC processor. Similarly, &€STACK RT and SET CMSTYPE RT are 
equivalent for the CMS EXEC rrocessor. However, when using EXEC 2, the 
commands &STACK HT and &STACK RI cause the characters "HT" and "RT" to 
be placed in the program stack and do not affect the console output. 
These characters must be used by a program or cieared from the stack. 
Otherwise, you wiil receive an "UNKNOWN CP/CMS COMMAND" error message 
when they are read from the [rogram stack. 


CMS/DOS Functions: 


The followiny functions describe the SET operands that apply to the 
CMS/DOS environment. 


DOS ON places your CMS virtual Machine in the CMS/DOS environment. 
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The logical unit SYSLOG is assigned to your terminal. 


node Specifies the mode letter at which the VSE system residence is 
accessed; the logical assignment of SYSRES is made for the 
indicated mode letter. 


VSAM specifies that you are going to use the AMSERV command or you 
are going to execute frograms to access VSAM data sets. 


DOS OFF returns your virtual machine to the normal CMS environment. 
All previously assigned system and programmer logical units 
are unasSigned. 


DOSLNCNT no 
specifies the number of SYSLST lines’ fer page. nnis an 
integer from 30 to 99. 


UPSI nuonnnnoan 
sets the UPSI (User Program Switch Indicator) byte to. the 
specified bit string of O's and 1's. If you enter fewer than 
eight digits, the UPSI byte is filied in from the left and 
zero-padded to the right. If you enter an "x" for any digit, 
the corresponding bit in the UPSI byte is left unchanged. 


UPSI OFF resets the UPSI Lyte to binary zeros. 


DOSPART nnonnnKk 
specifies the size of the virtual partition ib which you want 
a program to execute. The value, nnnnnK, may not exceed the 
amount of user free storage available in your virtual machine. 
You should use this function only when you can control the 
performance of a particular program by reducing the amount of 
available virtuad storage. 


Note: In rare circumstances, it may happen that when a progran 
is executed, the amount of storage available is less than the 
current DOSPART. Then, only the amount of storage available is 
obtained; no message is issued. 


OSPART OFF 
Specifies that you no longer want to control your virtual 
machine partition size. When the DOSPART setting is OFF, CMS 


computes the partition size whenever a program is executed. 
Usage Notes 
1. If you issue the SET ccmmand specifying an invalid function and the 
impiied CP function is in effect, you may receive message 
DMKCFCOO3E INVALID OPTION — option. 
22 If an invalid SET command function is specified from an EXEC and 


the implied CP function is in effect, then the return code is 


Responses 


None. To determine or verify the setting of a function, use the QUERY 
conmand. 
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Messages and Return Codes 


DMSLIOO002I 
DMSSETOI4E 
DMSSETO26E 
DMSSETO31E 
DMSSETO4TE 
DMSSETO4S8E 
DMSSETO50E 
DMSSETOO1E 
[TMSSETO70E 
DMSSETO98W 
DMSSET O099E 
DMSSET100W 
DMSSET142S 
DMSSET333E 
CMSSET400S 
DMSSET4015S 


DMSSET4105 


DMSSET444E 


FILE 'fn* TXILIE NOT FOUND RC=0 

INVALID FUNCTION ‘function" RC=24 

INVALID PARAMETER ‘parameter! FOR ‘function’ 
LOADER TAELES CANNOT EE MOLIFIED RC=40 

NO FUNCTION SPECIFIED RC=24 

INVALID MCDE ‘mode* kC=24 

PARAMETER MISSING AFTER ‘function" RC=24 
NO TRANSLATION CHARACTER SPECIFIED RC=24 
INVALID PARAMETER "parameter' RC=24 

CMS OS SIMULATION NOT AVAIIABLE kRC=4 
CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 
SYSTEM NAME ‘name* NOT AVAILABLE RC=4 

SAVED SYSTEM NAME ‘name* INVALID RC=24 
nnnnnK PARTITION TOO LARGE FOR THIS VIRTUAL MACHINE RC=24 
SYSTEM ‘sysname* DOES NOT EXIST kRC=44 


FUNCTION RC=24 


VeM. SIZE (size) CANNCT EXCEED ‘DMSDOS* START ADDRESS 
(address) RC=104 

CONTROL PROGRAM ERROR INDICATION 'retcode* kC=nnn 

Notes In kRC=nnn, the nun represents the actual error code 


generated by CP. 
VOLUME ‘label* IS NOT A DOS S¥SRES RC=32 
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Use the SETPRT command to load a virtual 3800 printer. The SETPRT 
command is valid only for a virtual 3800 printer. 


l 

| Chars [ (]cccc...[) ]] 
| jCOpies [ (Jnnn,) ] 
| CoPYnr [ (Joan) ] 
1 [Feb [ (]ffZ£[) ] 
[ Flash [ (JfffFf[) ] 

i Init 

| |Modify [ (Jmmma[n][) } 
l 


CHARS cccc... 
specifies the names of from one to four character arrangement 
tables (CATS) tc kLe loaded into the virtual 3800. CAT names 
May be from one to four alphameric characters. The CATs must 
exist as "XTBicccc TEXT’ files on an accessed CMS disk. 


COPIES nna 
specifies the total number of copies of each page to be 
printed. The value of non must be a number from 1 to 255. 
The default value is 1. 


COPYNR nan 
specifies the copy number of the first copy in a copy group. 
The value of nnn must be a number from 1 to 255. If COPYNR is 
not specified, a starting cory number of 1 is assumed. 


FCB ££ff 
specifies the FCB to ke loaded into the virtual 3800. The FCB 
Must exist as a 'FCB3ff£F£fFf TEXT' file on an accessed CMS disk 
unless £fff is specified as 6, 8, or 12. In that case, the 
FCB is not leaded from a CMS file. CP determines’ the 
appropriate FCB to load and prints the entire file at 6, 8, or 
12 lines per inch. 


FLASH id nan 
Specifies the one- to four-character overlay name (id) and the 
number of copies of each fage (nnn) to be printed with the 
overlay indicated by ‘id*. muon may be a number from 0 to 255. 
If n is not specified, 1 is the default. If the FLASH keyword 
is omitted, no cofies are printed with an overlay. 


INIT specifies that an "Initialize Printer" CCW will be issued 
before any other functions specified in this command are 
performed. 


MODIFY mnomn [nn] 
specifies cory modification data to be loaded. The copy 
modificaticn must exist as a ‘'MOD1immmm TEXT' file on an 
accessed CMS disk. Further, n specifies the CAT to use for 
the copy modification lcad. If n is omitted, 0 is the 
default. : 
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Note: Keyword values must be enclosed in parentheses only if they could 
be interpreted as a SETPRI keyword or keyword abbreviation. Otherwise 
the parentheses may Le omitted. 


Usage Notes: 


1. The values specified with the COPYNR, COPIES, and FLASH keywords 
override values specified in the SPOOL command except that multiple 
copies specified in the SFOOL command result in that number of 
retransmissions of the file. 


2. CATs must be specified so that they correspond to the appropriate 
TRC bytes. The first CAT specified corresponds to TRC byte 0, the 
second CAT corresfonds to IRC Lyte 1, and so on. 


3. CATS can reference the Library Character Set modules that IEBIMAGE 
supports. 


4. If the number of copies specified with the FLASH keyword is greater 
than the number of copies specified in COPIES ann, the actual 
number of copies printed will equal the number specified with the 
FLASH keyword. Thus, if you want all copies to be printed with an 
overlay, you can specify the number with the FLASH keyword and onit 
the COPIES keyword. 


5. The use of "INIT" and "FCB 6/8/12" together causes the printer to 
always be reset to 6 lines fer inch as would the use of 'INIT' 
alone. Both the INIT CCW andthe ‘CP SPOOL OOE FCB 6/8/12' 
generated by the 'FCE 6/8/12" are passed to CP. The LOADFCB CCW is 
sent ot the printer before the INIT CCW. This resets the FCB to 
the Init IMPL Default of 6 lines per inch. 'INIT' and ‘FCB ffff' 
does not have this problem, since 'FCB ffff" is handled directly by 
CMS. 


Responses 


DMSSPR196I PRT cuu SETUP COMPLETE 
The virtual 3800 printer was successfully loaded. 


Other Messages and Return odes 

DMSSPROO2ZE FILE ‘fn ft" NOT FOUND 

DMSSPRO1T4E INVALID KEYWORD ‘keyword! 

DMSSPRO26E INVALID VALUE ‘value FOR ‘keyword! KEYWORD 
DMSSPR113S PRINTER ‘OQOE* NOT ATTACHED RC=100 
DMSSPR145S INTERVENTION RECUIRED ON PRINTER RC=100 
DMSSPR197S UNDIAGNOSED ERROR FROM PRINTER ‘OOE" RC=100 
DMSSPR198E SETPRI CAUSED A LOAD CHECK - SNS=SSSSSSSSSS 
DMSSPR199E PRT OOE NCT A VIRTUAL 3800 

DMSSPR2ZO4E TOO MANY WCGM NEEDED FOR CHARS 

DMSSPR352E INVALID SETPRT DATA IN FILE ‘fn ft! 
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Use the SSERV command in CMS/DOS to copy, display, print, or punch a 
book from a VSE source statement library. The format of the SSERV 
command is: 


SSERV sublib booknane 


{ (options.-. [) J] 


options: 
[DISK] [PRINT] 
[ PUNCH [TERA ] 


rca a a ee | 


eee ee gee fee Oe ee eee 
aan Oe fe Ow ee Se ee 


where: 


sublib specifies the saurce statement sublibrary in which the book is 
cataloged. 


bookname specifies the: name of the book in the VSE private or systen 
source statement sublibrary. The private library, if any, is 
searched before the system library. 

ft specifies the filetype of the file to be created on your 


A-disk. ft defaults to COPY if a filetype is not specified. 
The filename is always the same as the booknane. 


Qptions: You may enter as many options as you wish, depending upon 
the functions you want to perform. 

DISK copies the book to a CMS file. 

PUNCH punches the book on the virtual punch. 

PRINT spools a copy of the book to your virtual printer. 


TERM displays the book on your terminal. 


Usage Notes 


1. %$«If you want to copy books from private libraries, you must issue an 
ASSGN command for the logical unit SYSSLB and identify the library 
on a DLBL command line using a ddname of IJSYSSL. 


If you want to copy books from the system library, you must have 
entered the CMS/DOS environment specifying the mode letter of the 
system residence volume. 


2- You Should not use the SSERV command to copy books from macro (E) 
Sublibraries, Since they are in "edited" (that is, compressed) 
form. Use the ESERV command to copy and de-edit macros froma 
Macro (E) sublilfrary. 


Responses 


When you use the TEKM option, the specified book is displayed at the 
terminal. 
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Messages and Return Codes 


DMSSRVOO3E 
DMSSRVOOUE 
DMSSRVOO06E 
DMSSRVO7OE 
DMSSRVOYJT7E 
DMSSRVO98E 
DHSSRVO99E 
DMSSRV105S 
DMSSRV113S 
DMSSRV4115S 
DMSSRV1945 


INVALID OPTION ‘option! RC=24 

BOOK '‘subl.book® NOT FOUND RC=28 

NO READ/WRITE "A* DISK ACCESSED RC=36 

INVALID PARAMETER ‘parameter RC=24 

NO "SYSRES!' VOLUME ACTIVE RC=36 

NO BOOK NAME SPECIFIED RC=24 

CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 

ERROR 'nn* WRITING FILE ‘fn ft fm" ON DISK RC=100 
DISK (cuu) NCT ATTACHED RC=100 

INPUT ERROR CODE ‘nn ON * {SYSRES|SYSSLB}* RC=100 
BOOK 'subl.book' CONTAINS BAD RECORDS kC=100 
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Use the START command to begin execution of CMS, OS, or VSE programs 
that were previously loaded or fetched. The format of the START command 


£ 1 
j entry [args...] | 
toe I option: 
| (option [) ] | 
L J 


| 


entry passes control to the control section name or entry point name 
at execution time. The operand, entry, may be a filename only 
if the filename is identical to a control section name or an 
entry point name. 


* passes control to the default entry point. See the discussion 
of the LOAD command for a discussion of the default entry 
point selection. 


acgSeae. are arguments to ke passed to the started progran. If user 
arguments are specified, the entry or * operands must be 
specified; otherwise, the first argument is taken as the entry 
point. ArgumentS are passed to the program via general 
register 1. The entry operand and any arguments become a 
string of doublewords, one argument per doubleword, and the 
address of the list is placed in general register 1. 


Option: 


NO Suppresses execution of the program. Linkage editor and loader 
functions are performed and the program is in storage ready to 
execute, but control is not given to the program. START * and 
START (NO) are mutually exclusive. 


Usage Notes: 


1. Any undefined names cr references specified in the files loaded 
into storage are defined as zero. Thus, if there is a call or 
branch to a subroutine from a main program, and if the subroutine 
has never been loaded, the call or Eranch transfers control at 
execution time to location zero of the virtual machine. 


2. Do not use the START command for programs that are generated via 
the GENMOD command with the NOMAP option. The START command does 
not execute properly for such [frograms. 

3. When arguments are passed on the START command, the requirements of 
both CMS and the language of the application program must be met. 
For example, COBOL pragrams require arguments separated by commas: 

START * A,E,C 
See the appropriate language guide for detaiis on parameter 
requirements. 
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4. Issue the START command immediately following the LOAD and INCLUDE 
commands. If the LOAD and INCLUDE were issued in an EXEC 
procedure, issue the START command from within the EXEC as well. 

5. If START is issued from the virtual console or from an EXEC 2 EXEC, 
register Q points to an extended parameter list block. The 
extended parameter list for the START command pointed to py 
register 0 has the follcwing structure: 

DC A (EPLCMD) 
DC A (EPLARGBG) 
DC A (EPLARGGND) 
DC A (0) 
where; 
START entry any arguments 
EPLCMD EPLARGBG EPLARGND 
ors 
START entry 
EPLCMD EPLARGBEG 
EPLARGND 
Or: 
START 
EPLCMD 
EPLARGBG 
EPLARGND 
Responses 


DMSLIO740I EXECUTION BEGINS... 


is displayed when the designated entry point is validated. 


This message is suppressed if CMS/DOS is active and the COMP option 
is specified in the FETCH command. 


rIror Messages and Return Codes 


DMSLIOO21E ENTRY POINT ‘name* NCT FOUND RC=40 
DMSLIOO55E NO ENTRY FOINT DEFINED RC=40 
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STATE/STATEW 


Use the STATE command to verify the existence of a CMS, OS, or DOS file 
on any accessed disk; use the STATEW command to verify the existence of 
a CMS, OS, or DOS file on any accessed read/write disk. The formats of 
the STATE and STATEW commands are: 


where: 

fn is the filename of the file whose existence is to be verified. 
If fn is specified as *, the first file found satisfying the 
rest of the fileid is used. 

ft is the filetype of the file whose existence is to be verified. 
If ft is specified as *, the first file found satisfying the 
rest of the fileid is used. 

fn is the filemode of the file whose existence is to be verified. 
If fm is omitted, or specified as *, ail your disks are 
searched. 


Usage Notes: 


1. If you issue the STATEW command specifying a file that exists on a 
read-only disk, you receive error message DMSSTTOO2E. 


2. When you code an asterisk in the fn or ft fields, the search for 
the file is ended as soon as any file satisfies any of the other 
conditions. For example, the command: 


state * file 


executes successfully if any file on any accessed disk (including 
the system disk) has a filetype of FILE. 


3. To verify the existence of an OS or VSE file when DOS is set OFF, 
you must issue the FILEDEF command to establish a CMS file 
identifier for the file. For example, to verify the existence of 
the OS file TESI.DATIA on an OS C-disk you could enter: 


faledef check disk check list c dsn test data 
state check list 


where CHECK LIST is the CMS filename and filetype associated with 
the OS data set name. 


4. To verify the existence of an OS or VSE file when the CMS/DOS 
environment is active, you must issue the DLBL command to establish 
a CMS file identifier for the file. For example, to verify the 
existence of the DOS file TEST.DATA ona DOS C-disk, you could 
enter: 


dlbl check c dsn test data 
State file check 
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where FILE CHECK is the default CMS filename and filetype (FILE 
ddname) associated with the VSE file-id. 


5. You can invoke the STATE/SIATEW command from the terminal, from an 
EXEC file, or as a function from a program. If STATE/STATEW is 
invoked as a function or from an EXEC file that has the & CONTROL 


NOMSG option in effect, the message DMSSTTOO2E FILE ‘fn ft fm' NOT 
FOUND is not issued. 


Responses 
The CMS ready message indicates that the specified file exists. 
DMSSTT227I PROCESSING VOLUME ‘no IN DATA SET ‘data set name!’ 


The specified data set has multiple volumes; the volume being 


processed is shown in the message. The STATE command treats 
end-of-volume as end-of-file and there is no end-of-volune 
Switching. 


DMSSTT2281I USER LABELS BYPASSED ON LATA SET ‘data set name! 


The specified data set has disk user labels; these labels are 
Skipped. 


DMSSTTOO2E FILE ‘fn ft fm* NOT FOUND RC=28 

DMSSTTO4S8E INVALID MCDE ‘modet RC=24 

DMSSTTOS5S4E INCOMPLETE FILEILC SPECIFIED RC=24 

DMSSTTO62E INVALID ‘char IN FILEID ‘fn £t* RC=20 

CDMSSTTO69E DISK *mode* NOT ACCESSED kRC=36 

DMSSTTO7OE INVALID PARAMETEE ‘parameter* RC=24 

DMSSTT229E UNSUPPORTED OS CATA SET, ERROR ‘code kRC=code 

DMSSTT253E FILE ‘fn ft fm" CAN NOT BE HANDLED WITH 
SUPPLIED FLIST RC=88 
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SVCTRACE 


Use the SVCTRACE command to trace and record information about 
supervisor calls occurring in your virtual machine. The format of the 
SVCTRACE command is: 


ay a eg FT Oe ee EN ee Ge Gg Re Ae ee eee ee eee eT eee pe ee he ae 
| sSvcTrace | ion \ | 


where: 
ON Starts tracing all SVC instructions issued within CMS. 
OFF stops SVC tracing. 


Usage Notes 
1. The trace information recorded on the printer includes: 


e The virtual storage location of the calling SVC instruction and 
the name of the called program or routine 


e The normal and error return addresses 


e The contents of the general registers both before the SVC-called 
program is given ccntrol and after a return from that progran 


e The contents of the general registers when the SVC handling 
routine is finished frocessing 


e The coatents of the floating-point registers before the 
SV¥C-called program is given control and after a return from that 
program 


e The contents of the floating-point registers when the SVC 
handling routine is finished processing 


e The parameter list passed to the SVC 


2. To terminate tracing previously established by the SVCTRACE 
command, issue the HO or SVCTRACE OFF commands. SVCTRACE OFF and 
HO cause all trace information recorded, up to the point they are 
issued, to be printed on the virtual spooled printer. On 
typewriter terminals SVCTRACE OFF can be issued only whea_ the 
keyboard is unlocked to accept input to the CMS command 
environment. To terminate tracing at any other point in systen 
processing, HO must’ be issued. To suspend tracing temporarily 
during a osession, interrupt processing and enter the Immediate 
command SO (Suspend Tracing). To resume tracing that was suspended 
with the SO command, enter the Immediate command RO (Resune 
Tracing). 


If you issue the CMS Immediate command HX or you log off the 
VM/SP system pbefore termination of tracing previously set by the 
SVCTRACE command, the switches are cleared automatically and all 
recorded trace information is printed on the virtual spooled 
printer. 
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If a user timer exit is activated while SVCTRACE is active, 
SVCTRACE is disabled for the duration of the timer exit. Any SVCs 
issued during the timer exit are not reflected in the SVCTRACE 
listing. 


3. When tracing on a virtual machine with only one printer, the trace 
data is intermixed with other data sent to the virtual printer. 
Responses 


A variety of information iS printed whenever the: 


SVCTRACE ON 


coBmand is issued. 


The first line of trace output starts with a dash or plus sign or an 
asterisk (- or + or *). The format of the first line of trace output 


is: 


5 


rc 


N/D = xxx/dd name FROM loc CLDPSW = pswl GOPSW = psw2 [RC=rc] 


indicates information recorded before processing the SVC. 


indicates informaticn recorded after processing the SVC, unless 
the asterisk (*) apfrlies. 


indicates information recorded after processing a CMS SVC that 
had an error return. 


1s an abbreviation for SVC number and depth (or level). 

is the number of the SVC call (they are numbered sequentially). 
is the nesting level of the SVC call. 

is the macro or routine being called. 

is the program location from which the SVC was issued. 

is the PSW at the time the SVC was called. 

is the PSW with which the routine being called is invoked, if 
the first character of this line is a dash (-). If the first 
character of this line is a plus Sign or asterisk (+ or *), PSW2 
represents the PSW that returns control to the user. 

is the return code from the SVC handling routine in general 
register 15. This field is omitted if the first character of 
this line is a dash (-), or if this is an OS SVC call. Fora 
CMS SVC, this field is 0 1f the line begins with a plus sign 


(+), and nonzero for an asterisk (*). Also, this field equals 
the contents of R15 in the "GPRS AFTER" line. 
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The next two lines of output are the coatents of the general 
registers when control is fassed to the SVC handling routine. This 
output is identified at the left by ".GPRSB". The format of the output 
is: 


»~GPRSB 


Nou 
Ss S 
a> bp’ 
> 
& 


h h h *dddddddd* 
h h h *dddddddd* 
where h represents the contents of a general register in hexadecimal 
format and d represents the EBCDIC translation of the coatents of a 
general register. The contents of general registers 0 through 7 are 
printed on the first line, with the contents of registers 8 through F on 
the second line. The hexadecimal contents of the registers are printed 
first, followed by the EECDIC transiation. The EBCDIC translation is 
preceded and followed Ly an asterisk (*). 


The next line of output is the contents of general registers 0, 1, 
and 15 when control is returned to your program. The output is 
identified at the left by ".GPRS AFTER :". The format of the output is: 


~GPRS AFTER : RO-R1 = bh h ¥*dd* R15 = h *d* 


where h represents the hexadecimal contents of a general register and d 
is the EBCDIC transiation of the contents of a general register. The 
oniy general registers that CMS routines alter are registers 0, 1, and 
15 so only those registers are printed when controi returns to your 
program. The EBCDIC translation is preceded and followed by an asterisk 


(*). 


The next two lines cf output are the contents of the general 
registers when the SVC handling routine is finished processing. This 
output is identified at the left by ".GPRSS." The format of the output 
iss 


h *dddddddd* 


-GPRSS hh 
h h h *addddddd* 


h 
h 


where h represents the hexadecimal contents of a general register and d 
represents the EBCDIC translation of the contents of a general register. 
General registers 0 through 7 are printed on the first line with 
registers 8 through F on the second line. The EBCDIC translation is 
preceded and followed by an asterisk (*). 


The next line of output is the contents of the calling routine's 
floating-point registers. The output is identified at the left by 
".FPRS". The format of the output is: 


~FPRS = £ £ £ £ *gggg* 


where f represents the hexadecimal contents of a floating-point register 
and g is the EBCDIC translation of a floating-point register. Each 
floating point register is a doukleword; each f£ and g represents a 
doubleword of data. The EBCDIC translation is preceded and followed by 
an asterisk (*). 


The next line of output is the contents of floating-point registers 
when the SVC handling routine is finished processing. The output is 
identified by ".FPRSS" at the left. The format of the output is: 


eFPRSS = £ £ £ f£ *¥gggg* 
where f represents the hexadecimal contents of a floating-point register 
and g is the EBCDIC translation. Each floating-point register is a 


doubleword and each f and g represents a doubleword of data. The EBCDIC 
translation is preceded and followed by an asterisk (*). 
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The last two lines of output are printed only if the 
register 1 is a valid address for the virtual machine. If 
output is the parameter list passed to the SVC. The 
identified by “.PARM" at the left. The output format is: 


SVCTRACE 


address in 
printed, the 
output is 


~PARM = hh hhoh+orsa~hisdhi=sh;é **dddddddd* 
=hhhhhshsh»h *dddddddd* 
where h represents a word of hexadecimal data andd is the EBCDIC 


translation. The parameter list is found at the address contained in 


register 1 


before control is passed to the SVC handling program. The 


EBCDIC translation is preceded and followed by an asterisk (*). 


Figure 30 summarizes the types of SVC trace output. 


re eg Gee ee ge Ng Oe pe Ege Se Ng Pe EE eps EN a TE Pe ey ge te ee ee eee oy 
| Identification | Comments i 
l | 
1 (-) NY/D {The SVC and the routine that issued the SVC. | 
1 <+ [ l 
] (* l | 
l | | 
| »~GPRSB {Contents of general registers when control is passed | 
( {i to the SVC handling routine. 
! l l 
| -GPRS AFTER |Contents of general registers 0, 1, and 15 when J 
; | control is returned to your progran. | 
| l l 
| ~GPRSS {Contents of the general registers when the SVC | 
| | handling routine is finished processing. | 
{ | i 
| «FPRS {Contents of floating-point registers before the | 
| | SVC-called program is given control and after | 
J | returning from that progran. 
| l ! 
| «FPRSS {Contents of the floating—point registers when the | 
| | SVC handling routine is finished processing. | 
( l i 
| ~PARM |The parameter list, when one is passed to the SVC. { 


ee a a er a | 


Figure 30. Summary of SVC Trace Output Lines 


Messages and Return Codes 

DMSOVRO14E INVALID FUNCTION 'function' RC=24 

DMSOVRO47TE NO FUNCTION SPEEIFIED RC=24 

DMSOVR104S ERROR ‘nn* REALING FILE "DMSOVR MODULE" ON DISK 
DMSOVR109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 
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Use the SYNONYM command to invoke a table of synonyms to be used with, 
or in place of, CMS and user-written command names. You create the 
table yourself using the CMS editor. The form for specifying the 
entries for the table is described under "The User Synonym Table." 


The names you define can te used either instead of or in conjunction 
with the standard CMS copmand truncations. However, no matter what 
truncations, synonyms, or truncations of the synonyms are in effect, the 
full real name of the command is alwayS accepted. The format of the 
SYNONYM command is: 


l l r r r o3wan d 
| SY¥Nonyn | lin | SYNONYM |fm4|| [ (options...[) ]] l 
l j I i IAIEI] 1 
| | L u j* ja | 
| l L J | 
j | : r 1 i 
I i options: |STD | [CLEAR] ( 
[ ; | NOSTD| i 
\ ' ; | 


where: 
fn is the filename of the file containing your synonyms table. 
fn is the filemode of the file containing your synonyms; if 
omitted, your A-disk and its extensions are searched. If you 
specify fp, you must enter the keyword, SYNONYM. If you 
specify fm as an asterisk (*), all disks are searched for the 
specified SYNONYM file. 
Options: 
STD specifies that standard CMS abbreviations are accepted. 


NOSTD standard CMS abbreviations are not to be accepted. (The full 
CMS command and the synonyms you defined can still be used.) 


CLEAR removes any synonym table set by a previously entered SYNONYM 
command. 


Usage Notes 


1. If you enter the SYNONYM command with no operands, the systen 
Synonym table and the user synonym table (if one exists) are 
listed. 


2- The SET ABBREV ON ox CFF command, in conjunction with the SYNONYM 
command, determines which standard and user-defined forms of a 
particular CMS command are acceptable. 


3. EXEC procedures having a synonym defined for them can be invoked by 
its synonym if implied EXEC (IMPEX) function is on. However, 
within an EXEC procedure, only the EXEC filename can be used. A 
Synonym is not recognized within an EXEC since the synonym tables 
are not searched during EXEC processing. 
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IHE USER SYNONYM TABLE 


You create the synonym table using the CMS editor. The table must be a 
file with the Filetype SYNONYM. The file consists of 80-byte 
fixed-length records in free-form format with columns 73-80 ignored. 
The format for each record is: 


systemcommand usersynonym count 


where: 


systenconmand 
is the name of the CMS command or MODULE or EXEC file for which you 
are creating a synonyn. 


usersynonyn 
is the synonym you are assigning to the command nane. When you 
create the synonym, you must follow the same syntax rules as for 
commands; that is, ycu must use the character set used to create 
commands, the synonym may be no longer than eight characters, and 
so on. 


count is the nininum number of characters that must be entered for the 
Synonym to be accepted by CMS. If omitted, the entire synonym nust 
be entered (see the following example). 


A table of command synonyms is built from the contents of this file. 
You may have several synonym files tut only one may be active at a time. 
For example, if the synonym file named MYSYN contains: 


MOVEFILE MVIT 
then, after you have issued the command: 

Synonym mysyn ey 
the synonym MVIT can be entered aS a command name to execute the 
MOVEFILE command. It cannot be truncated since no count is specified. 
If MYSYN SYNONYM contains: 

ACCESS GETDISK 3 


then, the synonyms GET, GEID, GETDI, GETDIS, or GETDISK can be entered 
as the command name instead of ACCESS. 


If you have an EXEC file named TIDISK, you might have a synonym entry: 
TDISK TDISK 2 


so that you can invoke the EXEC procedure by specifying the truncation 
ID. 


The Relationship between the SET ABEREV and SYNONYM Commands 

The default values of the SET and SYNONYM commands are such that the 
System synonyn abbreviation table is available unless otherwise 
specified. 


The system synonym abbreviation table for the FILEDEF command states 
that FI is the thininuno truncation. Therefore, the acceptable 
abbreviations for FILEDEF are: fFi, FIL, FILE, FILED, FILEDE, and 
FILEDEF. The system Synomyn abbreviation table is available whenever 
both SET ABBREV ON and SYNONYM (STD) are in effect. 
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If you have a synonym table with the file identification USERTAB 
SYNONYM A, that has the entry: 


FILEDEF USENAME 3 


then, USENAME is a synonym for FILEDEF, and acceptable truncations of 
USENAME are: USE, USEN, USENA, USENAM, and USENAME. The user synonyn 
abbreviation table is availatle whenever both SET ABBREV ON and SYNONYM 
USERTAB are specified. 


No matter what synonyms and truncations are defined, the full real 
name of the command is always in effect. 


Figure 31 lists the forms of the system command and user synonyms 
available for the various combinations of the SET ABBREV and SYNONYM 
coumands. 


Responses 


When you enter the SYNONYM command with no operands, the synonyn 
table(s) currently in effect are displayed. 


SYSTEM USER SHORTEST 
COMMAND SYNONYM FORM (IF ANY) 


This response is the same as the response to the command QUERY 
SYNONYM ALL. 


DMSSYN711I NO SYSTEM SYNCNYMS IN EFFECT 


This response is displayed when you issue the SYNONYM command with 
no operands after the command SYNONYM (NOSTD) has been issued. 


DMSSYN712I NO SYNONYMS (DMSINA NOT IN NUCLEUS) 


The system routine which handles SYNONYM command processing is not 
in the systen. 


Other Messages and Return Codes 

DMSSYNOO2ZE FILE ‘fn £t Em* NOT FOUND RC=28 

DMSSYNOOSE INVALID OPTION ‘option® RC=24 

DMSSYNOO7E FILE ‘fn ft fm* NOT FIXED, 80 CHAR RECORDS RC=32 
DMSSYNO32E INVALID FILETYPE ‘ft* RC=24 

DMSSYNOSOE FILE 'fn £t fm' CONTAINS INVALID RECORD FORMATS RC=32 
DMSSYNO66E ‘option AND ‘option ARE CONFLICTING OPTIONS RC=24 
DMSSYN104S ERROR 'nn'* REALING FILE 'fn ft fm" FROM DISK RC=100 
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SS ee ig a me Re 2 ee gee ge a ee ee en ee ee eee eee ee 


| Acceptable | 
{ Command | 
Options A Forms { Comments 
SET ABBREV ON | Fi {fhe ABBREV ON option of the SET 
SYN USERTAB (STD | FIL | command and the STD option of the 
bh | SYNONYM command make the systen 
Lo | table available. The user synonya, 
| « | USENAME, is available 
| FILEDEF | kecause the synonym table 
| USE | (USERTAB) is specified on the 
| USEN | SYNONYM command. The truncations 
lL | for USENAME are available because 
|. | SET ABBREV ON was specified with 
t <s | the USERTAB also available. 
| USENAME i 
SET ABBREV OFF FILEDEF The user—defined synonym, USENAME, 
SYN USERTAB (STD USENAME is permitted because the user 


l 
l 
| synonym table (USERTAB) is speci- 
{| fied on the SYNONYM command. No 

| system or user truncations are 

| permitted. 

SET ABBREV ON 

SYN USERTAB (NOSTD 


FILEDEF 
USE 
USEN 


| |The system synonym table is un— 

| | available because the NOSTD option 
| | is specified on the SYNONYM con— 
|e | mand. The user synonym, USENAME, 

bos eg | is available because the user syno-— 
i | nym table (USERTAB) is specified on 
| {| the SYNONYM command and the trunca— 
i {| tions of USENAME are permitted 

| | because SET ABBREV ON is specified 
| | with USERTAB also available. 


USENAME 


SET ABBREV OFF 
SYN USERTAB (NOSTD 


FILEDEF 
USENAME 


|The system synonym table is nade 

| unavailable either by the SET 

| ABBREV OFF command or by the SYN 
| (NOSTD command. The synonyn, 

| USENAME, is permitted because the 
| user—defined synonym table 

| (USERTAB) is specified on the 

| SYNONYM command. The truncations 
| for USENAME are not permitted 

| because the SET ABBREV OFF option 
| 1s in effect. 


SET ABBREV ON 
SYN (CLEAR STD 


iThe user—defined table is now un— 
| available. The system synonyn 
| table is available because both 

° | the ABBREV ON option of the SET 
| command and the STD option of the 
| SYNONYM command are specified. 


ea = ese eae & 
6 


FILEDEF 


SET ABBREV OFF 
SYN (CLEAR STD 


FILEDEF Because CLEAR is specified on the 
SYNONYM command, the synonym and 
its truncations are no longer 
available. Either the SET ABBREV 
OFF command or the SYNONYM (NOSTD 
command make the system synonyn 


table unavailable. 


I 
| 
: 
SET ABBREV ON | 
SYN (CLEAR NOSTD | 
———$___—_________ | 
l 

l 


SET ABBREV OFF 
SYN (CLEAR NOSTD 
a a 


Figure 31. System and User—Defined TIruncations 


Qe fe Oe Oe ee Oe ee oe Ee ee Bee eee ee eee ee oe ee Oe ee ee ee ee ees ee ee Oe ee ee ee eee fee Ee ee ee ee Oe eee ie Ee ee oe Oe ee ee ae Ee ee ee ee ee ee eee eee ee ee eee ee ee 
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Use the TAPE command to dump CMS-formatted files from disk to tape, load 
previously dumped files from tape to disk, and perform various control 
operations ona specified tape drive. Files processed by the TAPE 
command must be in a unigue CMS format. The TAPE command does not 
process nultivolume files. Disk files to be dumped can contain either 
fixed- or variable-length records. The format of the TAPE command is: 


cr | 

TAPE DUMP ea ft) Ifo 
* * \* | [ (optionA optionB optionD[) ]] 

L J 


l l 4 
l l ( 
[ \ | 
l | ! 
| d r ro4 | 
i | LOAD ae ee ifm| | [ (optionB optionc optionD[) ]] i 
l l 1 (* } * iA i i 4 
| | L L J J | 
l { r 1 i 
l i SCAN | a ea | [ (optionB oftionC optionD[) }] i 
; | l * = l l 
{ l ‘ = ( 
{ i r 1 l 
i | SKIP | ea a1 | { (optionB optionC optionD[) ]]f | 
( l 1 (* * 4 4 
| l . _ l 
! | l 
| ( DVOL1 [ (optionD option£E;) j] { 
{ ( WVOL1 volid [owner } [ (optionD option£[) ]] l 
l \ I 
| ( MODESET [ (optionD[) }j | 
4 | r4 l 
| tapemd jni —§ [ (oftionD[) }] | 
{ | 11] 4 
i i ire i 
[ | r 16 1 4 
i | optiona: [WIM | JBLRSIZE (003 | i i 
l l INOWDTMI | 800) | | 
] | L J kL | | 
i | r 1 A 
i | optionB: JNOPRint| | 
| | JPRint | | 
l l | Term { | 
| l | DISK i l 
| 4 - 4 | 
l i r 1 l 
i 1 optionc: {EOT | | 
{ | [EOF n| 4 
4 l [EOF 1| | 
| l ee | 
| { rr 11 ~6¢°F 1 l 
| | optionD: J{TAPn J] J7TRACK| [DEN den] [TRTCH a] | 
| l [iZTAP1 [i |J9YTRACK| { 
i l \& 4, +t = l 
i ( Ir ai | 
l i jjcuu J] ( 
( { 11181 [1 : 
| | LL JJ | 
| i r 1 l 
| | optionE: JREWIND | | 
\ l ALEAVE | l 
4 l = : l 


322 IBM VM/SP CMS Command and Macro Reference 


TAPE 


DUMP Jfn(jsfti[ fn] 
* * ([* ] 
dumps one or more disk files to tape. If fn and/or ft is 


specified as an asterisk (*) all files that satisfy the other 
file identifier are dumped. 


If fm is coded aga letter, that disk and its extensions are 
searched for the specified file(s). If fm is coded as a 
letter and number, only files with that mode number and letter 
(and the extensions of the disk referenced by that fm letter) 
are dumped. If fm is coded as asterisk (*), all accessed 
disks are searched for the specified file(s). If fm is not 
specified, only the A-disk and its extensions are searched. 


LOAD Nahe ra 
Cl* yt* Jia J] 
reads tape files onto disk. If a file identifier is 
specified, only that one file is loaded. If the option EOF an 
is specified and no file identifier is entered, n tape files 
are written to disk. If an asterisk (*) 1S specified for fn 
or ft, all files within ECF n that satisfy the other file 
identifier are loaded. 


The files are written to the disk indicated by the filemode 


letter. The filemode numker, if entered, indicates that only 
files with that filemode number are to be loaded. 


= HM) 


positions the tape at a specified point, and lists’ the 


identifiers of the files it Scans. Scanning occurs over n 
tape marks, as specified by the option EOF n (the default is 1 
tape file). However, if a file identifier (fn and ft) is 


specified, scaaning stops upon encountering that file; the 
tape remains positioned ahead of the file. 


SKIP ‘eg sea 
Co ET 2 
positions the tape at a specified point and lists’ the 
identifiers of the files it skips. Skipping occurs over a 
tape marks, aS specified by the option EOF n (the default is 1 
tape mark). However, if afile identifier (fn and ft) is 
specified, skipping stops after encountering that file; the 
tape remains positioned immediately following the file. 


MODESET sets the values specified by the DEN, TRACK, and MTRITCH 
options. After initial specification in a TAPE command, these 
values remain in effect for the virtual tape device until they 
are changed in a subseguent TAPE command, RDTAPE, WRTAPE, or 
TAPECTL macro. See Usage Note 7 for further explanation. 


= 
{| specifies a tape control function (tapcmd) to be executed n 
| times (default is 1if n is not specified). These functions 

t 4 also work on tapes in a non-CMS format. 


Tapcmd Action 

BSF Backspace n tape marks 

BSR Backspace n tape records 

ERG Erase gap 

FSF Forward-space n tape marks 
FSR Forward-space n tape records 
REW Rewind tape to load point 
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Tapcma Action 
RUN Rewind tare and unload 
WIM Write n tape narks 


DVOL1 displays an 80-character VOL1 label in EBCDIC on the user's 
terminal if such a label exists on the tape. If the first 
record on the tape is not a VOL1 label, an error message is 
sent to the user. 


WVOL1 volid [ owner ] 

writes a VOL1 label on a tape. All fields are set’ to the 
Same values they are set to when a VOL1 label iS written by 
the IBM-supplied IEHINITT utility progran (see the 
publication OS/VS2 MVS Utilities for details). The volid is 
set to the 1- to 6-character volid specified on the command. 
If the user specifies owner field, it is written in the owner 
name and address code field of the label. It can be up to 
eight characters long and left-justified in the 10-byte field 
in the label. If not specified, the owner field is set to 
blanks. The WVCL1 option also writes a dummy HDR1 label and 
tape mark after the VCL1 label. 


Options: 


If conflicting options are specified, the last one entered is in 
effect. 


WIM writes a tape mark on the tape after each file is dumped. 

NOWTM writes a tape mark after each file is dumped, then backspaces . 
over the tafe mark so that subseguent files written on the } 
tape are not sefarated Ey tape marks. 


BLKSIZE 4096 

BLKSIZE 800 | 
specifies the size of the tape data block at which the files 
are to be dumped (not including a five-byte prefix). 


NOPRINT does not spool the list of files dumped, loaded, scanned, or 
skipped to the printer. 


PRINT spools the list of files dumped, loaded, scanned, or skipped 
to the printer. 


TERM displays a list of files dumped, loaded, scanned, or skipped 
at the terminal. 


DISK creates a disk file containing the list of files dumped, 
loaded, scanned, or skipped. The disk file has the file 
identification of TAPE MAP A5. 


EOT reads the tape until an end-of-tape indication is received. 

EOF n reads the tape through a maximum of no tape narks. The 

EOF 1 default is EOF .1. 

TAPn specifies the symbolic tape identification (TAPn) or _ the 

18n actual device address of the tape to be read from or written 
to where nis 1, 2, 3, or 4. The default is TAP1 or 181. 
The unit specified by cuu must previously have been attached , 
to your CMS virtual machine before any tape I/O operation can ) 
be attempted. Only symbolic names TAP1 through TAP4Y and 


virtual device addresses 181 through 184 are supported. 
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7TRACK specifies a 7-track tape. Odd parity, data convert on, and 


translate off are assumed unless TRICH is specified. 


9TRACK specifies a 9-track tafe. 


DEN den is the tape density where den is 200, 556, 800, 1600, or 


6250. If 200 or 556 is specified, 7TRACK is assumed. If 
1600 or 6250 is specified, 9TRACK is assumed; if 800 is 
specified, Q9IRACK is assumed unless 7TRACK is specified. In 
the case of either 800/1600 or 1600/6250 dual-density drives, 
1600 is the default if the 9TRACK option is specified. If 
neither the 9TRACK option nor’ the DEN option is specified, 
the drive operates at whatever bpi the tape drive was last 
set. 


TRICH a is the tape recording technique for 7-track tape. If TRICH 


is specified, 7IRACK is assumed. One of the following must 
be specified as "a": 


a Meaning 

O Odd parity, data convert off, translate off 
oc Odd parity, data convert on, translate off 
OT Qdd parity, data convert off, translate cz 

E Even parity, data convert off, translate cif 
ET Even parity, data convert off, translate on 


REWIND are only valid for the DVOL1 and WVOL1 functions. They 
LEAVE specify the positioning of a tape after the VOL1 is 


processed. If REWIND is specified, the tape is rewound and 
positioned at load _ foint. If LEAVE (the default) is 
specified, the tare is positioned at the record immediaxely 
after the VOL1 lakel. 


Usage Notes 


1. 


Tape records written by the CMS TAPE DUMP command are either 805 
bytes long, if the option BLKSIZE is specified as 800; or 4101 
bytes long if the BLKSIZE is specified as, or defaults to, 4096. 
Toe first character iS a binary 2 (X*'02'), followed by the 
characters CMS and a file format byte. For a variable format file, 
the file format byte is V. For a fixed format file without null 
blocks, the file format byte is F; otherwise the file format byte 
is S. In the final record, the character N replaces the file 
format byte, and the data area contains CMS file directory 
information. A tape created at 4096-byte block size is not 
reloadable on a CMS system that does not have the amultivalue 
BLKSIZE option on the TAPE command; however, the 800-byte BLKSIZE 
option provides backward compatibility to such a systen. 


If a tape file contains more CMS files than would fit on a disk, 
the tape load operation may terminate if there is not enough disk 
space to hold the files. To frevent this, when you dump the files, 
separate logical files by tafe marks, then forward space to the 
appropriate file. 


Because the CMS file directory is the last record of the file, the 
TAPE command creates a separate workfile so that backspacing and 
rereading can ke avoided when the disk file is built. If the load 
criteria is not satisfied, the workfile is erased; if it is 
Satisfied, the workfile is renamed. This workfile 1S named TAPE 
CMSUT1, which may exist if a previous TAPE command has abnormally 
terminated. If the work file ig accidentally dumped to’ tape and 
subsequently loaded, it apfrears on your disk as TAPE CMSUT2. 
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The RUN option (rewind and unload) indicates completion before the 
physical operation is completed. Thus, a subsequent operation to 
the same phySical device may encounter a device busy situation. 


It is possible to run a tape off the reel inat least one 
Situation. If you specify EOF n and n is greater than the number 
of tape marks on the tape, the tape will run off the reel. 


DVOL1 and WVOL1 are the only TAPE command functions’ that 
automatically process tape labels. TAPE DUMP does not 
automatically write labels on a tape when it writes the dump file, 
and TAPE LOAD does not reccgnize tape labels when loading a file. 


To reset the mode of a variakle tape drive when using an IBM 
Standard label tape for output, rewrite the VOL1 label before 
processing tape using the TAPE WVOL1 command. This is a hardware 
restriction which allows changes to the tape drive mode only when 
the tape is at load point. If ycu are writing to a non-label tape, 
use the TAPE MODESEI command to set the mode. The first write 
operation will cause the mode to be reset since the tape will be at 
loadpoint when the write takes flace. 


Do not use TAPE DVOL1 for a tape that you suspect to be blank. If 
you do, and the tape is blank, it will run off the reel. 


The options for the 8809 tape drive. must be STRACK and DEN 1600. 
Note that these are the default values, so you do not need to 
specify then. 


10. For more information on tape file handling, see the VM/SP CM 
User's Guide. 
Responses 


DMSTPE701I NULL FILE 


A final record was encountered and no prior records were read ina 
TAPE LOAD operation. No file is created on disk. 


If the TERM option is in effect, the following is displayed at the 
terminal depending on the oferaticn specified: 


LOADING..... 
fn ft fm 


SKIPPING..... 
fn £t £m 


DUMPING...-<.- 
fn ft fn 


SCANNING.....« 
fn ft fn 
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When 


a tape 


TAPE 


mark iS encountered, the following is displayed at' the 


terminal if the TERM oftion is specified: 


END-OF-FILE OR END-OF-TAPE 


Cther Messages and Return Codes 


DMSTPEOO2E 
DMSTPEOO3E 
DMSTPEO10E 
DMSTPEO14E 
DMSTPEO17E 
DMSTPEO23E 
DMSTPEO27E 
DMSTPEO29E 


DMSTPEO37E 
DMSTPEO42E 
DMSTPEO43E 
DMSTPEO4TE 
DMSTPEO4SE 
DMSTPEOSTE 
DMSTPEO58E 
DMSTPEO69E 
DMSTPEO7OE 
DMSTPEOS6E 
DMSTPE104S 
DMSTPE105S 
DMSTPE110S 
DMSTPE111S 
DMSTPE113S 
DMSTPE115S 


DNSTPE431E 


NOT FOUND RC=28 
"option* Rc=24 
PREMATURE EOF ON FILE ‘fn ft fm' RC=40 
INVALID FUNCTION "'function* RC=24 
INVALID DEVICE ADDRESS ‘cuu® RC=24 

NO FILETYFE SFECIFIED RC=24 
INVALID DEVICE ‘device name' 
INVALID PARAMETER ‘parameter’ 
RC=24 

DISK ‘mode* IS READ/CNLY 
NO FILEID SPECIFIED RC=24 
"TAPn (cCuu)*® IS FILE PROTECTEL kRC=36 
NO FUNCTION SPECIFIED RC=24 

INVALID MODE ‘mode* RC=24 

INVALID RECORD FORMAI RC=32 
END-OF-FILE OR END-OF-TAPE RC=40 
DISK ‘mode* NOT ACCESSED RC=36 
INVALID PARAMETER ‘parameter* kC=24 


FILE 'fn ft fn' 
INVALID CPTICN 


RC=24 


IN THE OPTION ‘option! FIELD 


kC=36 


FILE ‘fn ft" DATA BLOCK COUNT INCORRECT RC=32 

ERROR ‘nn* READING FILE ‘fn ft fm' FROM DISK RC=100 
ERROR ‘nn* WRITING FILE ‘fn ft fm ON DISK RC=100 
ERROR REACLING *TAPn(cuu)* RC=100 

ERROR WRITING "TAPn(cuu)* RC=100 

TAPn (cuu) NOT ATTACHED RC=100 


{CONVERSION] {719}-TRACK| {800]6250} BPI| TRANSLATION] DUAL 
DENSITY} FEATURE NOT SUPPCRTED CN DEVICE ‘cuut RC=88 
"TAPn(cuu)* VOL1 LABEL MISSING RC=32 
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TAPEMAC 


Use the TAPEMAC command to create a CMS MACLIB from an unloaded 
partitioned data set (PDS) from a tape created by the IEHMOVE utility 
Program under OS. The PIS from which the tape was created can he 
blocked, but the logical record length must be 80. The format of the 
TAPEMAC command is: 


4 d 1 I 
| TAPEMAC | fn {SL [lakbeldefid}] i [ (options[) )] | 
| | |NSL filename [ID=identifier ]| J 
| | = | 
l | options: | 
j | r a6 | | 
| | JTAPnH||ITEMCT yyyyyl | 
| i [| TAPIT,(LTEMCT 50000) i 
| | Xu JL | { 


where; 

fn specifies the filename of the first, or only, CMS MACLIB to be 
created on the A-disk. If fn MACLIB already exists on the 
A-disk, the old one is erased; no warning message is issued. 

SL heans that the tape has standard labels. The default is SL 
without a labeldefid. With the default specification, the 
Standard header labels are only displayed on the user's 
terminal. If labeldefid is specified, the standard iabels are 
not displayed, but are checked by the tape label checking 
routine. 

NSL means that the tape has ncnstandard labels. 

lateldefid 


identifies the LABELDEF command that supplies descriptive 
label inforwation for the file to be processed. The 
labeldefid given here must match the 1- to 8-character 
identifier specified as the filename on the LABELDEF command 
that was previously issued. 


filename is the CMS filename of a routine to process’ nonstandard 
labels. The filetype must be TEXT or MODULE. If . both TEXT 
and MODULE files exist, the MODULE file is used. MODULE files 
that are used for NSL routines with the TAPEMAC command must 
be created so that they start at an address above X*21000°'. 
This prevents the NSL amcdules from overlaying the command. 
See the section "Tape Lakels in CMS" in the VM/SP CMS User's 
Guide for details cn how to write routines to process 
nonstandard labels. 


ID=identifier 

specifies a 1- to 8-character identifier to be passed toa 
user-written NSL routine. You may use the identifier in any 
way you want to identify the file being processed. The 
identifier is passed to the user routine exactly as specified 
in the ID operand. If an identifier is not specified, blanks 
are passed. See the section "Tape Labels in CMS" in the VM/SP 
CMS User's Guide for details on communicating with routines 
that process nonstandard labels. 
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Options: 


TAPh specifies the symbolic address of the tape, where n iS a number 
between 1 and 4 corresponding to virtual device addresses 181 
through 184, respectively. The default is TAP1. 


ITEMCT yyyyy 
specifies the item count threshold of each MACLIB to be 
created, which is the maximus number of records’ to be written 
into each file. (commas are not allowed). If ITEMCT is not 
specified, the default is 50000. | 


Usage Notes 


1. 


Tape records are read and placed into fn MACLIB until the file size 
exceeds the ITEMCT (item count); loading then continues until the 
end of the current member is reached. Then another CMS file is 
created; its filename consists of the number 2 appended to the end 
of the filename specified (fn) if the filename is seven characters 
or less. The appended number overlays the last character of the 
filename if the name is eight characters long. Loading then 
continues with this new name. For example, if you enter’ the 
command: 


tapemac mylib 


you may create files named SMYLIB MACLIB, MYLIB2 MACLIB, MAYLIB3 
MACLIB, and So on. 


This process continues until up to nine CMS files have _ been 
created. If more data exists on the tape than can fit in nine CMS 
files, processing is terminated with the error message DMSTMA139S. 
A maclib created by the TAPEMAC command may contain a nmaxinmun of 
256 directory entries. 


Only header labels of the first file encountered are displayed or 
checked if SL or SL labdefid is specified. Trailer labels are not 
processed or displayed; they are skipped. 


The following examples illustrate the different ways tape labels 
are processed by TAPEMAC. The command 


tapemac mac6 sl 


displays any standard VOL1 or HDR1 labels on a tape before loading 
maclib MAC6. It does not stop before loading the MACLIB. 


If you specify 


labeldef taplab fid macfile crdte 77106 
tapemac mac8 sl taplak 


CMS checks the HDR1 label on the tape before loading MAC8. It uses 
the information you supplied in the LABELDEF command TAPLAB to 
check the label. If there are discrepancies between fields you 
specified in the LABELDEF command and in the actual tape label, the 
MACLIB is not loaded. 
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If you specify 


tapemac maci0 nsl nsl3 


CMS uses your own routine NSL3 to process tape labels before 
loading MAC10. 
Responses 
The TAPEMAC command displays the message: 
LOADING fn MACLIB 
for each macro library created. 
Other Messages and Return Codes 
DMSTMAOOQ1E NO FILENAME SPECIFIED RC=24 
DMSTMAOO3E INVALID CPTION ‘option*® kRC=24 
DMSTMAO57E INVALID RECORD FORMAT RC=32 
DMSTMAO69E DISK 'mode* NOT ACCESSED RC=36 
DMSTMAO7OE INVALID PARAMETER ‘parameter RC=24 
DMSTMA105S ERROR nn WRITING FILE fn ft ON DISK RC=1900 


CMSTMA109S 
DMSTMA110S 
DMSTMA137S 
DMSTMA138S 
DMSTMA139S 
DMSTMA420E 
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VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 

ERROR REALTING TAPn kRC=100 

ERROR no ON STATE FOR fn ft RC=100 

ERROR nn ERASING 'fn ft* BEFORE LOADING TAPE RC=100 
TAPE FILE EXCEEDS 9 CMS MACLIBS kRC=104 

NSL EXIT FILENAME MISSING OR INVALID RC=24 
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TAPPDS 


Use the TAPPDS command to create CMS disk files from tapes that are used 
as input to or output from the follcwing OS utility programs: 


e IEBPTPCH -- tape files must be the result of an IEBPTPCH punch 


operation from either a sequential or partitioned data 
set in OS. The default attributes (IEBPTPCH DCB) must 
have been issued: 


DCB= (RECFM=FA, LRECL=81, BLKSIZE=81) 


e IEBUPDTE -- tape files may be blocked or unblocked and must be in the 


e IJEHMOVE 


format accerted by IFBUPDTE as "control data set" (SYSIN) 
input with a control statement 


~/ ADD... 


preceding the records to be placed in each partitioned 
data set member (OS) or separate CMS file (CMS)). 


-- unloaded partiticned data sets are read. 


The tape can contain OS standard labels or be unlabeled. The format 
of the TAPPDS command is: 


TAPPDS 


l r r roo411 r 1 l 
| lin {ft | foil [SL {| lakeldefid} | i 
| i * | * JAWS INSL filename [1ID=identifier]| | 
i | l i* iii L J l 
| L a t 444 [ (options[) J] i 
l r 1 r 1 r 1 | 
l options: |PDS l {COL1 | |TAPn| l 
d INOPDS | | NOCOL1) [TAP1| { 
| J UPDATE] i J t J J 
l t 4 l 
| r 7 r 1 [ 
r i END | |MAXTEN | 
| | NOENLD| | NOMAXTEN | l 
L J L J | 


fn 


is the filename of the disk file to be created from the 
sequential tape file. If the tape contains members of a 
partitioned data set (FDS), fm must be specified as an 
asterisk (*); one file is created for each member with a 
filename the sane as the nember nane. If NOPDS or UPDATE is 
specified and you dc not specify fn or specify it as an 
asterisk (*), the default filename is TAPPDS. 


is the filetype of the newly created files. The default 
filetypes are CMS0UT1 (fcr PDS or NOPDS) and ASSEMBLE (for 
UPDATE). The defaults are used if ft is omitted or specified 
as *. 


is the node of the disk to contain the new files. If this 


field is omitted or specified as an asterisk (*), A1 is 
assumed. 
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SL 


NSL 


labeldefid 


filenane 


means that the tape has standard labels. The default is SL 
without a labeldefid. With the default specification, the 
standard labels are displayed at the user's terminal. If 
labeldefid is specified, the standard labels are not 
displayed, but are checked by the tape label checking 
routine. 


means that the tape has nonstandard labels. 


identifies the LABELDEF command, which supplies descriptive 
label information for the file to be processed. The 
labeldefid given here must match the 1- to §8-character 
specified as the filename on the LABELDEF command that was 
previously issued. 


is the CMS filename of a routine to process nonstandard 
labels. The filetype must be TEXT or MODULE. If both TEXT 
and MODULE files exist, the MODULE file is used. MODULE 
files that are used for NSL routines with the TAPPDS command 
must be created so that they start at an address above 
X*21000'. This prevents the MODULE files from overlaying the 
command. See the section "Tape Labels in CMS" in the VM/SP 
CMS User's Guide for details on writing routines to process 
nonstandard latels. 


ID=identifier 


specifies a 1- to 8-character identifier to a user-written 
NSL routine. You may use the identifier in any way you want 
to identify the file being processed. The identifier is 
passed to the user routine exactly as specified in the 
operand. If an identifier is not specified, blanks are 
passed. See the secticn "Tape Labels in CMS" in the VM/SP 
CMS User's Guide for details on communication with routines 
that process nonstandard labels. 


Note: If either SL or NSL is specified for tape label processing, the 
fn, ft, and fm operands must all be specified. They may be specified by 
asterisks (*) if you want default values; however, none of the three 
operands may be omitted. 


Options: If conflicting options are specified, the last one entered 
ais the one that is used. Ali options, except TAPn, are ignored when 
unloaded (IEHMOVE) PDS tapes are read. 


PDS 


NOPDS 


UPDATE 


indicates that the tape contains members of an OS partitioned 
data set, each preceded Ly a MESBER NAMF--name statement. The 
tape must have reen created by the OS IEBPTPCH service 
program if this option is specified. 


indicates that the contents of the tape “ill be placed in one 
CMS file. 


indicates that the tape file is in IEBUPDTE control file 
format. The filename of each til<= is taken from the NAME= 
parameter in the "./ ADD" record that precedes each nember. 
(See Usage Note 2.) 


reads data from columns 1-80. you should specify this option 
when you use the UPDATE cpt+ua. 


reads data from columns 2-81; column 1 contains’ control 
character information. This is the format produced by the OS 
IEBPTPCH service frogran. 
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TAPn is the tape unit numker. non can be 1, 2, 3, or 4, 
, 


representing virtual units 181, 182, 183, and 184 
respectively. If not specified, TAP1is assumed. 


END considers an END statement (characters "END ' in columns 2-5) 


a delimiter for the current nember. 


NOEND specifies that END statements are not to be treated as member 


delimiters, but are to be processed as text. 


MAXTEN reads up to ten members. This is valid only if the PDS 


option is selected. 


reads any number cf members. 


Usage Notes 


1. 


You can use the TAPE command to position a tape at a particular 
tape file before reading it with the TAPPDS command. If the tape 
has OS standard labels, TAPDDS will read and display the "VOL1" and 
"HDR" records at the terminal. If the file you want to process is 
not at the beginning of the tape, the TAPE command must be used to 
position the tape at a particular tape file before reading it with 
the TAPPDS command. Be aware that each file onan 0OS standard 
label tape is actually three physical files (HDR, DATA, TRAILER). 
If positioning to other than the first file, the user must skip 
more physical tape files (3n-3 if positioning to the header labels, 
3n-2 if positioning to the data file, where n is the number of the 
file on the tare). 


If you use the UPDATE option, you must also specify the COL1 
option. Each tape record is scanned for a "./ ADD" record 
beginning in column 1.2 When a "./ ADD" record is found, subsequent 
records are read onto disk until the next "./ ADD" record is 
encountered or until a "./ ENDUP"™ record is encountered. 


A "“./ ENDUP™ record or a tape mark ends the TAPPDS' conmand 
execution; the tape is not repositioned. 


"./ label" records are not recognized by CMS and are included in 
the file as data records. 


If the NAME= parameter is missing on the "./ ADD" record or if it 
is followed by a Llank, TAPPDS uses the default filename, TAPPDS, 
for the CMS disk file. If this happens more than once during the 
execution of the command, only the last unnamed member is contained 
in the TAPPDS file. 


If you are reading a macro library from a tape created by the 
ITEHMOVE utility, you can create a CMS MACLIB file directly by using 
the TAPEMAC command. 


Only header labels of the first file encountered are displayed or 
checked if SL or SL labeldefid is specified. Trailer labels are 
not processed or displayed; they are skipped. When more than one 
file is processed by one issuance of the TAPPDS command, only the 
first file has its standard labels processed. Standard labels are 
skipped on succeeding files. 


The following examples illustrate different ways in which tape 
labels are processed by TAPPDS. If you specify 


tappds fileg cmsut1 * sl 
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then, before loading the PDS into fileg, CMS displays a VOL1 and 
HDR1 label if it exists on the tape. It does not stop before the 
PDS is loaded; therefare, you cannot use the tape label to suppress 
loading if the wrong tape has teen mounted. 


If you specify 


labeldef label2 fid pds1 volid xyz 
tappds fileh cusut1 * sl label2 


CMS uses the label information specified 


to check 


the label on the 


tape before loading your PES. If there are discrepancies, the PDS 
1s not loaded. 


If you specify 


CMS uses 


tappds filej * * nsl nonstd 


before loading the PDS. 


Responses 


DMSTPD/031 


FILE 'fn ft [£m]* COPIED 


The named file is copied to disk. 


DMSTPD7071 


TEN FILES COPIED 


your own routine called NONSTD to process tape labels 


The MAXTEN option was specified and ten members have been copied. 


Note: If the tape being read contains standard OS labels, the labels are 2 
displayed at the terminal. 


Other Messages and Return Codes 


DMSTPDOO3E 
DMSTPDO58E 
DMSTPD1055 
DMSTPD109S 
DMSTPD110S 
DMSTPD420E 


INVALID CPTICN *option*® RC=24 

END-OF-FILE OR END-OF-TAPE RC=40 

ERROR "nn* WRITING FILE ‘fin ft fm* ON DISK 
VIRTUAL STORAGE CAPACITY EXCEEDED kRC=104 
ERROR ‘nn* REALING "TAPn(cuu)* RC=100 

NSL EXIT FILENAME MISSING OR INVALID RC=24 
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Use the TELL EXEC procedure to send a message to one or more computer 
users on your computer or on other computers that are connected to yours 
via the Remote Spooling Communications Subsystem (RSCS) network. These 
users must be logged on to receive your message. 


TELL is one of several commands that references a "userid NAMES" file. 
By setting up a names file, you can identify recipients just by using 
hicknames, which are automatically converted into node and userid. For 
information on creating a NAMES file, see the NAMES command. 


The format of the TELL command is: 


JTELL | name message | 


hane is the "name" of the computer user to whom the message is to 
be sent. If the same recipient is specified more than once, 
he receives only one message. The "name" may take any of the 
following forms: 


e A "nickname" that can be found in the file "userid NAMES", 
where "userid" is your userid. This nickname may represent 
a Single person (on your computer or on another computer), 
or a list of people. If the nickname represents a list, 
the message is sent to everyone on the list. 


e A userid of a user on your computer. If a name cannot be 
found in the "userid NAMES" file, it is assumed to bea 
userid of someone on your computer. 

e “userid AT node” which identifies a user ("userid") on your 
computer or another computer ("node"). The "userid NAMES" 
file is not examined in this case. 

You cannot send messages to a userid named "AT" or CC:", 

message is the text of the message that is sent. 


Usage notes: 


1. If the first word of your message is "at", you must use the third 
form of "name" (shown above). 


2. If the person to whom you are sending the message either is not 


logged on or is not accepting messages (by issuing CP SET MSG OFF), 
he will not receive the message. 


DMSWTL637E Missing Nodeid for the AT operand. RC=24 

DMSWTL647E Userid not specified for ‘nickname in ‘Userid 
NAMES' File. RC=32 

DMSWIL648E Userid 'name* not found. No message has been sent. 
RC=32 

DMSWTL676E Invalid character '*' for Network ID. RC=20 


Section 2. CMS Commands 335 


TXTLIB 


TXTLIB 


Use the TXTLIB command to update CMS text libraries. The format of the 
TXTLIB command is: 


| TxXTlib | GEN libname fnl [fn2 ...] l 
l l l 
J i ADD liknane fnl jfn2 ... ] options: | 
| l r 1 l 
| | DEL libname membernanel [{ membernane2... ] J|TERM | | 
l | [DISK | l 
| | MAP libname [ (oftions...[) }] | PRINT| | 
| { = l 


where: 

GEN creates a fTXTLIB on your A-disk. If a TXTLIB with the sane 
hame already exists, it is replaced. 

ADD adds TEXT files to the end of an existing TXTLIB on a 
read/write disk. No checking is done for duplicate names, 
entry points, or CSECTs. 

DEL deletes members from a fxXTLIB on a read/write disk and 
compresses the TXILIB to remove unused space. If more than 
one member exists with the same name, only the first entry is 
deleted. 

MAP lists the names (entry points) of TXTLIB members, their 


locations in the library, and the number of entries. 


1ibnane specifies the filename of a file with a filetype of TXTLIB, 
which is to be created or listed or from which members are to 
be deleted or added. 


fni1 [fn2... ] 
specifies the name(s) of fiie(s) with filetype(s) of TEXT, 
that you want to add to a TXTLIB. 

nmembernanel [ membernane2... ] 


specifies the name(s) of TXTLIB member(s) that you want to 
delete. 


Options: 
TERN displays information about the TXTLIB on your terminal. 


DISK writes a CMS file, named likname MAP A5, that contains a list 
Of TXTLIB members. 


PRINT spools a copy of the IXTLIB map to the virtual printer. 


Usage Notes 


1. When a TEXT file is added to a library, its membername(s) are taken 
from the CSECT names or NAME statements in the TEXT file. Deletions 
and LOAD or INCLUDE command references must be nade on these names. 
For example, a TEXT file with a filename of TESTPROG that contains 


336 IBM VM/SP CMS Command and Macro Reference 


TXTLIB 


CSECTS named CHECK and RECHECK, when added to a TXTfLIB, creates 
members named CHECK and RECHECK. 


2. Members must be deleted by their initial entry in the dictionary 
{that is, their "name" or the first ID name). Any attempt to 
delete a specific alias or entry point within a member will result 
in a "Not found" message. 


3. If you want your TXTILIBs to be searched for missing subroutines 
during CMS loader processing; you must identify the TXTLIB ona 
GLOBAL command; for example; 


global txtlib newlib 


4H. You may add OS linkage editor control statements NAME, ALIAS, 
ENTRY, and SETSSI to a TEXT file before adding it to a TXTLIB. You 
must follow OS linkage editor conventions concerning format (column 
1 must be blank) and placement within the TEXT file. The specified 
entry point must be located within the CSECT. 


5. TXTLIB members are not fully link-edited, and may return erroneous 
entry points during dynamic loading. 


6. The total number of nemkers in the TXTLIB file cannot exceed 1000. 
When this number is reached, an error message is displayed. The 
total number of entry points in a member cannot exceed 255. When 
this number is reached, an error tessage is displayed and the next 
text file (if there is one) is processed. The text library created 
includes all the text files entered up to (but not including) the 
one that caused the cverflow. 


7. TERM or PRINT options will erase the old MAP file, if one exists. 


{| 8. If you delete the last remaining member of a TXTLIB, the TXTLIB is 
| erased. 


Responses 


When the TXTLIB MAP command is issued with the TERM option, the contents 

of the directory of the specified text library are displayed at the 

terminal. The number of entries in the text library (xxx) is also 
| displayed. Note: Alias names follow the main member and they do not 
| have a location field. 


ENTRY INDEX 
Hane location 


xxx ENTRIES IN LIERARY 


Other Messages and Return Codes 


CMSLBTOO1E NO FILENAME SPECIFIED RC=24 

DMSLBTOO2ZE FILE '£n ft" NCT FOUND RC=28 

DMSLBTOO2W FILE ‘fn £t* NOT FOUND RC=4 

DMSLBTOO3E INVALID CEPTION ‘option!’ RC=24 

DMSLBTO13E MEMBER ‘name* NOT FOUND IN LIBRARY ‘fn ft fm* RC=32 
DMSLBTO1GE INVALID FUNCTION "function® RC=24 

DMSLBTO37E DISK '‘mode* is READ/ONLY RC=36 

DMSLBTO46E NO LIBRARY NAME SPECIFIED RC=24 

DMSLBTO47E NO FUNCTICN SPECIFIED RC=24 

DMSLBTOS6E FILE ‘fn ft fm" CONTAINS [NAME|[ALIASJ[ENTRYJ[ESD] INVALID 
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MEM nane 

displays member(s) of a library. If the format of the file is t ; 
MACLIB or TXILIE, a MEMBER entry can be specified. If an 
asterisk (*) is specified, all members of the library are 
displayed. If a name is specified, only that particular member 
is displayed. 


MEMBER { x 


Usage Notes 


1. If the HEX option is specified, each record can be displayed in its 
entirety; if not, no more than 130 characters of each record can be 
displayed. 


2. The length of each output line is limited to 130 characters or the 
current terminal linesize (as specified by the CP TERMINAL 
command), whichever is smaller. 


3. If the MEMBER option is specified more than once, only the last 
member specified will be typed. However, if one MEMBER option is 
coded with an asterisk (*), and another MEMBER option is specified 
with a membername, only the member specified by membernane will be 
typed, regardless of their order on the command line. 


For example, if you code: 

TYPE ONE MACLIE (MEMBER EXAMPLE1 MEMBER EXAMPLE2 
Only EXAMPLE2 will be typed. If you code: 

TYPE ONE MACLIB (MEMBER EXAMPLE1 MENBER * 


only EXAMPLE1 will be typed. ww 


Responses 


The file is displayed at the terminal according to the given 
specifications. When you use the HEX option, each record is preceded by 
a header record: 


RECORD nnnnnnnnnn LENGTH=nnnnnnnnnn 


Other Messages and Return Cades 

DMSTYPOO2E FILE ‘fn ft fm' NCT FOUND RC=28 

CMSTYPOO3E INVALID OPTION ‘option kRC=24 

DMSTYPOO5E NO "option! SPECIFIEL RC=24 

DMSTYPOOSE COLUMN ‘col* EXCEEDS RECORD LENGTH RC=24 

DMSTYPO13E MEMBER ‘name* NCT FOUND IN LIBRARY R&C=32 

DMSTYPO29E INVALID PARAMETER ‘parameter' [IN THE OPTION ‘option FIELD] 
RC=24 

DMSTYPO33E FILE ‘fn £t fm*' IS NCT A LIBRARY RC=32 

DMSTYPO39E NO ENTRIES IN LIBRARY ‘fn ft fm* RC=32 

DMSTYPO4Y9SE INVALID LINE NUMBER ‘line number’ RC=24 

DMSTYPOS4E INCOMFLETE FILEID SPECIFIED RC=24 

DMSTYPO62E INVALID * IN FILEID RC=20 

CMSTYPO69E DISK ‘mode* NOT ACCESSED RC=36 

DMSTYP104S ERROR ‘nn* REALING FILE ‘fn ft fm" FROM DISK RC=100 
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Use the UPDATE command to modify program source files. The UPDATE 
command accepts a source input file and one or more files containing 
UPDATE control statements and updated source records; then it creates an 
updated source output file, an update log file indicating what changes, 
if any, were made, andan update record file if more than a Single 
update file is applied to the input file. The format of the UPDATE 
colmand is: 


a a a Se 
l l r r a1 | 
{| Update 4 fn1 | ft1 |}fm1 [fn2 [f£t2 [fn2]])i] [ (options...[) ]] | 
| l [ASSEMBLE [A1 ll l 
i i L L j4 i 
l l r 1 r 2 r 1 c 7 l 
l l options: |REP | ISEQS =| {INC |] {CTL | l 
l i 1 NCEEP | | NOSEQ8 | | NOINC| |NOCTL] | 
i i L 4 L 4 u J L 4 i 
| | r 1 c 1 r 1 c 1 | 
| I ISTK | [TERM | 1DISK | {STOR | l 
| | | NOSTK ] {NOTERM | | PRINT| {NOSTOR| { 
i i L 4 L 4 L J L J | 


where: 

Eni f£t1 fm1 
is the file identifier of the source input file. The file 
must consist of 80-cCharacter card image records with sequence 
fields in jpositions 73 through 80 or 76 through 80. If the 
filetype or filemode are omitted, ASSEMBLE and Al are assuned, 
respectively. 

fn2 ft2 fn2 
is the file identifier of the update file. If the NOCTL 
option is in effect, this file must contain UPDATE control 
statements and updated source records. The default file 
identifier is fol UPDATE Al. If the CTL option is specified, 
this file must ke a control file that lists the update files 
to be applied; the default file identifier is fn1 CNTRI A1. 

Options: 


REP creates an output source file with the same filename as the 
input source file. If the output file is placed on the same 
disk as the input file, the input file is erased. 


NOREP retains the old file in its original form, and assigns a 
different filename to the new file, consisting of a dollar 
Sign ($) plus the first seven characters of the input filename 
(fn1). 


SEQ8 specifies that the entire sequence field (columns 73 through 
80) contains an eight-digit Sequence number on every record of 
source input. 


NOSEQ8 
specifies that columns 73-75 contain a _ three-character label 
field, and that the sequence number is a five-digit value in 
columns 76-80. 
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INC 


NOTERM 


PRINT 


STOR 


Note: Source files sequenced by the CMS editor are sequenced, 
by default, with five-digit sequence numbers. 


increments seguence numbers ia columns 73 through 80 in each 
record inserted into the updated output file, according to 
specifications in UPDATE control statements. 


puts asterisks (*******%) in the seguence number field of each 
updated record inserted from the update file. 


Specifies that fn2, £t2, and fm2 describe an update control 
file for applying multiple update files to the source input 
file. (See "The CIL Option.") 


Note; The CTL option implies the INC option. 


specifies that a single update file is to be applied to the 
source input file. 


Stacks information from the control file in the CMS console 
Stack. SIK is valid only if the CTL option is also specified 
and is useful only when the UPDATE command is executed in an 
EXEC procedure. 


does not stack ccntrol file information in the console stack. 


displays warning messages at the terminal whenever a sequence 
or update control card error is discovered. (Such warning 
messages appear in the update log, whether they are displayed 
at the terminal or not.) 


Suppresses the display of warning messages at’ the terminal. 
However, error messages that terminate the entire update 
procedure are displayed at the terminal. 


places the update log file on disk. This file has a file 
identifier "fn UPDLOG", where "fn" is the filename of the file 
being updated. 


prints the update log file directly on the virtual printer. 


Specifies that the source input file is to be read into 
storage and the updates performed in storage prior to placing 
the updated source file on disk. This option is neaningful 
only when used with the CTL option since the benefit of 
increased processing Speed is realized when processing 
Multiple updates. STOR is the default when CTL is specified. 


specifies that no updating is to take place in storage. 
NOSTOR is the default when single updates are being applied 
(CTL is omitted from the command line). 


UPDATE CONTROL STATEMENTS 


The UPDATE control statements let you insert, delete, and replace source 
records, as well as reseguence the cutput file. 


All references to the sequence field of an input record refer to the 
humeric data in columns 73-80 of the source record, or columns 76-80 if 
NOSEQ8 is specified. Leading zeros in sequence fields are not required. 
If no sequence numbers exist in an input file, a preliminary UPDATE with 
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only the './ S' control statement can be used to establish file 
sequencing. 


Sequence numbers are checked while updates are being applied; an 
error condition results if any sequence errors occur in the update 
control statements, and warnings are issued if an error is detected in 
the seguencing of the input file. Any source input records with a 
seguence field of eight blanks are skipped, without any indication of a 
seguence error. Such records may be replaced or deleted only if they 
occur within a range cf records that are being replaced or deleted 
entirely and if that range has limits with valid seguence numbers. 
There is no means provided for specifying a sequence field of blanks on 
an UPDATE control statement. 


Control Statement Format 


All UPDATE control statements are identified by the characters './' in 
columns 1 and 2 of the 80-Eyte record, followed by one or more blanks 
and additional, ktlank-delinited fields. Control statement data must not 
extend beyond column 50. 


SEQUENCE Control Statement -- resequences the updated source output file 
in columns 73-80 (if SEQ8 is specified), or in columns 76-80 with the 
label placed in columns 73-75 (if NOSEQ8 is specified). The format of 


the SEQUENCE control statement is: 


a Ne Re ey eae See, PRES a eRe EN Fe Sgn ae Se he Og Se ee pe ee 
1 -/f S [segstrt [segincr [latel]]] | 
ee ee | 


segstrt is a one- to eight-digit numeric field specifying the 
first decimal sequence number to be used. The default 
value is 1000 if SEQ8 is specified and 10 if NOSEQ8 is 
specified. 


segincr is a one- to eight-digit numeric field specifying the 
decimal increment fcr reseguencing the output file. 
The default is the "segstrt" value. 


label 1s a three-character field to be duplicated in colunmas 
73-75 of each source record if NOSEQ8 is specified. 
The default value is the first three characters of the 
input filename (fn1). 


If you use the SEQUENCE statement, it must be the first statement in the 
update file. If any valid control statement precedes it, the resequence 
operation is suppressed. 


When the sequence control statement is the first statement processed, 
the sequence numbers ia the source file are checked and warning message 
CMSUPD210W is issued for any errors. If the seguence control statenent 
is processed after updates have been applied, no warning messages will 
ke issued. 


Each source record is reseguenced in columns 73-80 as it is written 


onto the output fale, including unchanged records from the source file 
and records inserted from the update file. 
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INSERT Control Statement -- inserts all records following it, up to the 
next control statement, into the output file. The format of the INSERT 
control statement is: 


a en ee 

i -/ I segqno [$ [seqstrt [Segincr]]}] | 

| | 

where: 

seqno is the sequence number of the record in the source 


input file following which new records are to be added. 


$ is an ofticnal delimiter indicating that the inserted 
records are to be sequenced by increments. 


seqstrt is a one- to eight-digit numeric field specifying the 
first decimal number to be used for sequencing the 
inserted records. 


seqincr is a one- to eight-digit numeric field specifying the 
decimal increment for sequencing the inserted records. 


All records following the "./ I" statement, up to the next control 
statement, are inserted in the output file following the record 
identified by the "seqno" field. If the NOINC option is specified, each 
inserted record is identified with asterisks (********) in colunns 
73-80. If either the INC or CTL option is specified, the records are 
inserted unchanged in the output file, or they are sequenced according 
to the "segstrt" and "segincr" fields, if the dollar sign ($) key is 
specified. 


The default sequence increment, if the dollar sign is included, is 
determined by using one tenth of the least significant, nonzero digit in 
the segno field, with a maximum of 100. The default segstrt is computed 
as segqno plus the default Segincr. For example, the control statenent: 


-/ I 2600 ¢ 2610 


causes the inserted records to be seguenced XXX02610, XXX02620, and so 
forth (NOSEQ8 assumed here). For the control statement: 


ef I 240000 § 
the defaulted segincr is the maximun, 100, and the starting sequence 
Dumber is 240100. SEQ8 is assumed, so the inserted records are 
seguenced 00240100, 00240200, and so forth. 
If either INC or CTL is specified but the dollar sign is not 


included, whatever sequence number appears on the inserted records in 
the update file is included in the output file. 
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DELETE Control Statement -- deletes one or more records from the source 
file. The format of the DELETE ccntrol statement is: 


i -/ D segnoi1 [segno2) [$] 
SS See 


re 
where: 
seqnol is the sequence number identifying the first or only 
record to Le deleted. 
seqno2 is the seguence number of the last record to be 
deleted. 
$ is an optional delimiter indicating the end of the 


control fields. 


All records of the input file, beginning at segnol, up to and 
including the segno2 record, are deleted from the output file. If the 
segno2 field is omitted, only a Single record is deleted. 


REPLACE Control Statement -- replaces one or more input’ records with 


updated records from the update file. The format of the REPLACE control 
statement is: 


SS ea 
| -/ R segnol [seqno2] [$ [segstrt [seqincr]]]] 
eee 


where: 

seqnol is the sequence number of the first input record to be 
replaced. 

seqno2 is the seguence number of the last record to be 
replaced. 

$ is an optional delimiter key indicating that the 
substituted records are to be sequenced incrementally. 

segstrt is a one- to eight-digit numeric field specifying the 
first decigal number to be used for sequencing the 
substituted records. 

seqincr is a one- to eight-digit numeric field specifying the 
decimal increment for sequencing the substituted 
records. 


All records of the input file, beginning with the segnol record, up 
to and including the segno2 record, are replaced in the output file by 
the records following the "., R" statement in the update file, up to the 
next control statement. AS with the "./ D" (delete) function, if the 
segqno2 field is omitted, only a single record is replaced, but it may be 
replaced by more than a single inserted record. The "./f/ R®" (replace) 
function is performed as a delete followed by an insert: thus, the 
number of statements inserted need not match the number deleted. The 
dollar sign (3), sSegstrt, and segincr processing is identical to that 
for the insert function. 
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COMMENT Statement --allows inserting supplemental information that the 


user may want. The format of the CCMMENT statement is: 


BT soc ge ae ee eg ee ee ae eg eS te ee 
{ -f * [comment ] 


* indicates that this is a comment statement and is only 
copied into the update log file. 


SUMMARY OF FILES USED BY THE UPLATE CCMMAND 


The following discussion shows input and output files used by the UPDATE 
command for a: 


e Single-level update 
e Multilevel update 
e Multilevel update with an auxiliary control file 


Disk Mcde of Qutput Files: If several read/write disks are accessed when 
the UPDATE command is invoked, the following steps are taken to 
determine the disk upon which the output files are to be placed (the 
search stops aS soon as one of the following steps is successful): 


1. If the disk on which the criginal source file resides is 
read/write, then the cutput files are flaced on that disk. 


2. if that disk is a read-only extension of a read/write disk, then 
the output files are pflaced on that particular read/write disk. 


3. If neither of the other steps is successful, the output files are 
placed on the primary read/write disk (the A-disk). 


Single-Level Update 


aaa 
| | fn ASSEMBLE -———————— 
| 1 fn UPDATE l j) $f£n ASSEMBLE 
| | l 1 fn UPDLOG 
SS l | 

nd 

update fn 

Notes: 


fn ASSEMBLE is the source input file. 


ne ae ET 


fn UPDATE contains UPDATE control statements and updated source input 


records. 
dfn ASSEMBLE is the updated source file, incorporating changes, 


additions, and deletions specified in the update file. The output 
filetype is always the same as the filetype of the input file. These 
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default filetypes and filemodes can be overridden on the command line; 
for example: 

ufdate testprog cobol bk fix cokol b (rep 
results in a source file TIESTPROG CCBOL B being updated with control 
statements contained in the file FIX COBOL B. The output file replaces 
the existing TESTPRCG COEFCL E. 


fn UPDLOG contains a record of updates applied. If you do not want this 
file written on disk, specify the PRINT option. 


SS 
{ {1 £n ASSEMBLE ———_--———_r 
| i f£n CNTRL | | $fn ASSEMBLE 
l ! fn UPDTABC | | £n UPDLOG 
| | f£n UPDTXYZ | | fn UPDATES 
i | | l 
ee | eer | 
update fn (ctl 
otes: 


== aa = ae 


fn CNTRL is the control file that lists updates to be applied to the 
source file. These default filetypes and filemodes can be overridden on 
the conmand line; for exanjle: 


update acct pliopt a test cntrl a (ctl 


results in the file TESTI CNIRL being used by the UPDATE command to 
locate the update files for ACCT PLIOPT. 


fn UPDTABC and fn UPDIXYZ are update files containing UPDATE control 
Statements and new source records. These files must have filenames that 
acre the same as the source input file. The first four characters of the 
filetype must be ‘UPDTI'. The UPDATE command searches all accessed disks 
to locate the update files. 


$fin ASSEMBLE is the updated source file, incorporating changes, 
additions, and deletions specified in the update files. The filetype is 
always the same as the filetype of the source input file. 


ic 


PDLOG contains a record of updates applied. If you do not want this 


fn OG 
file written on disk, specify the PRINT option. 


fn UPDATES summarizes the updates applied to the source file. 
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The CONTROL FILE (in CNIRL) may not contain UPDATE control statements. 
It may only list the filetypes of the files that contain UPDATE control 
Statements. This control file contains the records: 


TEXT MACS CMSLIB 
TWO UPDTABC 
ONE UPDTXYZ 


where UPDTABC and UPDIXYZ are the filetypes of the update files. fhe 
UPDATE command applies these updates to the source file beginning with 
the last record in the ccntrol file. Thus, the updates in fn UPDTXYZ 
are applied before the updates in fn UPDTABC. 


When you create update files whose filetypes begin with ‘UPDT', you 
may omit these characters when you list the updates in the control file; 
thus, the CNITRL file may be written: 


TEXT MACS CMSLIB 
TWO ABC 
ONE XYZ 


TEXT, TWO, ONE: The first column of the control file consists of an 
update level identifier, which may te from one to five characters long. 
These identifiers are used by VM/SP updating procedures, like the VAFASM 
EXEC, to locate and identify text decks produced by multilevel updates. 


MACS: The first record in the ccntrol file must be a MACS record that 
contains an update level identifier (TEXT) and, optionally, lists up to 
eight macro library (MACLIE) filenames. 


UPDATE uses the information provided in the MACS card and the update al 
level identifier only when the STK option is specified. This 
information is, however, reguired in the CNTRL file. 


aaa ae aaa 
| | fn ASSEMBLE corr] $fn ASSEMBLE 
j } fn CNTRL i | fn UPDLOG 
| ij fn UPDTABC | j fn UPDATES 
| |} £n UPDTXYZ 4 | 
[ | fn AUXLIST l l 
LJ fn FIX01 ee tS ae | 

fn FIXO2 

update fn (ctl 

Notes: 
fn ASSEMBLE, fn CNTRL, fn UPDTABC, fn UPDIXYZ, $f£n ASSEMBLE, fn UPDLOG, 
and fn UPDATES are used as descriked, for "Multilevel Update," except 
that the CNTRL file contains: 


TEXT MACS CMSLIB 
TWO UPDTABC 


ONE UPDTXYZ ‘ ) 
TEXT AUXLIST 
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AUX in the filetype AUXLISI indicates that this is the filetype of an 
auxiliary control file that contains an additional list of updates. The 
first three characters of the filetype of an auxiliary control file must 
be "AUX"; the remaining character(s) (to a maximum of 5) may be 
anything. The filename must be the same as the source input file. 


An auxiliary file may also be specified as: 
XXxxXxX AUX 
in the control file. For example, the record: 
FIX TEST AUX 
identifies the auxiliary file fn AUXTEST. 


Note that if you give an auxiliary control file the filetype AUXPTF or 
an update level identifier of AUX, the UPDATE command assumes that it is 
a Simple update file and dces not treat it aS an auxiliary file. 


PREFERRED AUX FILE: A preferred AUX file may be specified. A preferred 
AUX file contains the version of an update that applies to your version 
of the source file. (There may be more than one version of the sane 
update if there is more than one version of the source file. For 
example, you need one version for the source file that has a system 
extension program product installed, and you need another version for 
the source file that does not have a program product installed.) 


When you specify an auxiliary control file, you can specify more than 
one filetype. The first filetype indicates a file that UPDATE uses only 
on one condition: the files that the second and subsequent filetypes 
indicate do not exist. If they do exist, this AUX file entry is ignored 
and no updating is done. The files that the second and subsequent 
filetypes indicate are preferred because, if they exist, UPDATE does not 
use the file that the first filetype indicates. For example, assume 
that the file 'fn ASSEMBLE' does exist. The control file MYMODS CNTRL: 


TEXT MACS MYMACS CMSLIB OSMACRO 
MY2 AUXTEST 
MY 1 AUXMINE AUXTEST 
and the command: 
UPDATE fn ASSEMELE * MYMODS CNTRL (CTL 


would result in UPDATE finding the preferred auxiliary control file ‘fn 
AUXTEST', and therefore not using 'fn AUXMINE' to update ‘fn ASSEMBLE’. 
UPDATE would then froceed to the MY2 AUXTEST entry and update ‘fn 
ASSEMBLE' with the updates listed in ‘fn AUXTEST.' It is assumed that 
AUXTEST and AUXMINE list similar but mutually exclusive updates. 


The search for a "preferred" auxfile will continue uatil one is found or 
until the token is an invalid filetype; that is, less than four or nore 
than eight characters. This token and the remainder of the line are 
considered a comment. 


fn FIX01 and fn FIX02 are update files containing UPDATE control 
Statements and new source records to be incorporated into the input 
file. When update files are listed in an auxiliary control file, they 
can have any filetype you choose but the filename must be the same as 
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the source input file. The update files, as well as_ the AUX file, may 
be on any accessed disk. These are indicated in fn AUXLIST as follows: 


FIXO2 
FIX01 


The updates are applied from the bottom of the auxiliary file. fMThus, fn 
FIX01 1s applied to the source file before fn FIX02. Since the 
auxiliary file is listed at the bottom of the control file, these 
updates are applied before UPDTXYZ and UPDTABC. 


ADDITIONAL CONTROL FILE RECORDS: In addition to the MACS’ record, the 
filetypes of update (UPDT) files, and the filetypes of auxiliary control 
(AUX) files, a control file may also contain: 


e Comments. These records begin with an asterisk (*) in column 1. 
Comments are also valid in AUX files. 


e PTF records. If the characters PTF appear in the update level 
identifier field, the UPDATE command expects the second field to 
contain the filetype of an update file. The filetype may be 
anything; the filename must be the same as the source input file. 


e Update level identifiers not asscciated with update files. 


The following example of a control file shows all the valid types of 
records: 


* Example of a control file 
ABC MACS MYLIB 


TEXT 
004 UPDTABC 
003 XYZ 


002 AUXLIST1 
001 LIST2 AUX 
PTF TESTFIX 


THE STK OPTION: The STK (Stack) option is valid only with the CTL option 
and is meaningful only when the UPDATE command is invoked within an EXEC 
Frocedure. 


When the STK option is specified, UPDATE stacks the following data 
lines in the console stack; 


first line: * update level identifier 
second line: * library list from MACS record 


The update level identifier is the identifier of the most recent update 
file that was found and applied. For example, if a ocontrol file 
contains 


TEXT MACS CMSLIB OSMACRO TESTMAC 
OFA UPDTOFA 
PFA UPDTOFA 
and the UPDATE command appears in an EXEC as follows: 
UPDATE SAMPLE (CTL STK 


&READ VARS &STAR &TEXT 
G&READ VARS &STAK &11IE1 &LIE2 GS1IE3 &LIB4 
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then the variable symbols set Ly the &READ VARS statements’ have the 
following values if the file SAMPLE UPDTOFA is found and appiied to the 
file SAMPLE ASSEMBLE: 


Symbol — Value 


ESTAR * 
&ETEXT OFA 
&LIB1 CMSLIE 
&LIB2 OSMACRO 
&LIB3 TESTMAC 
&LIB4 null 


The library list may be useful to establish macro libraries ina 
Subseguent GLOBAL command within the EXEC procedure. If no update files 
are found, UPDATE stacks the update level identifier on the MACS record. 


Responses 
FILE ‘fn £t fm,* REC #n = update control statement 


This message is displayed when the TERM option is specified and an 
error is detected in an update file. It identifies the file and 
cecord number where the error is found. 


DMSUPD177I WARNING MESSAGES ISSUEG (SEVERITY=nn). [*REP* OPTION 
IGNORED. ] 


Warning messages were issued during the updating process. The 
severity shown in the error message in the "nn" field is’ the 
highest of the return codes associated with the warning messages 
that were generated during the updating process. 


The warning return codes have the following meanings: 


RC = 4; Sequence errors were detected in the original source file 
being updated. 


RC = 8; Sequence errors, which did not previously exist in the 
source file being ufdated, were introduced in the output file 
during the updating prccess. 


RC = 12; Any other warning error detected during the updating 
process. Such errers include invalid update file control 
statemeats and missing update or PIF files. 


The severity value is passed back as the return code from the 
UPDATE command. In addition, if the REP option is specified in 
the command line, then it is ignored, and the updated source file 
has the fileid "$fnl1 £t1", as if the REP option was not specified. 


DMSUPD178I UPDATING ‘fn ft fo! 
AFPLYING ‘fn ft fn! 
APPLYING ‘fn ft fm 


The specified update file is being applied to the’ source file. 
This message appears only if the CTL option is specified in the 
command line. The updating process continues. 


Section 2. CMS Commands 351 


UPDATE 


DMSUPD3041I UPDATE PROCESSING WILL BE DONE USING DISK 


An insufficient amount of virtual storage was available to 
perform the updating in virtual storage, so a CMS disk must 
be used. This message is displayed only if NOSTOR was 
specified in the UPDATE command line. 


DMSUPD180W MISSING PIF FILE ‘fn £t fm* RC=12 


In the event that the user receives this message during the 
update process, the message MISSING PTF FILE ‘fn £t £m" will 
appear in the update log associated with the frogram being 
updated. 


Other Messages and Return Codes 


DMSUPDOOIE 
DMSUPDOO2E 
DMSUPDOO3E 
DMSUPDOOTE 
DMSUPDO10W 


DMSUPDO24E 
DMSUPDO37E 
DMSUPDO4S8E 
DMSUPDO65E 
DMSUPDO66E 
DMSUPDO69E 
DMSUPDO70E 
DMSUPD104S 
DMSUPD105S 
DMSUPD174qH 


DMSUPD176W 
DMSUPD179E 


DMSUPD180W 
DMSUPD181E 
DMSUPD182W 
DMSUPD183E 
DMSUPD184W 
DMSUPD185W 
DMSUPD 186W 
DMSUPD187E 
DMSUPD207W 
DMSUPD210W 
DMSUPD299E 
DMSUPD300E 


NO FILENAME SPECIFIED RC=4 

FILE ‘fn ft fm* NCT FCUND RC=28 

INVALID OPTION ‘option' RC=Z4 

FILE ‘fn ft fm" IS NCT FIXED, 80 CHAR. RECORDS RC=32 
PREMATURE EOF GF FILE 'fn ft fm' --SEQ NUMBER '......-.' NOT 
FOUND RC=12 

FILE "UPDATE CMSUT1 £m" ALREADY EXISTS RC=28 

DISK 'mode' IS READ/ONLY kC=36 

INVALID MCDE 'mode* RC=24 

‘option OPTION SPECIFIED TWICE RC=24 

‘option' AND ‘option" ARE CONFLICTING OPTIONS RC=24 

DISK "*mode* NOT ACCESSED k&C=36 

INVALID PARAMETER "parameter' RC=24 

ERROR 'nn* REALING FILE ‘fn £t fm" FROM DISK RC=100 

ERROR '‘nn* WRITING FILE "fn ft fm' ON DISK RC=100 

SEQUENCE ERRGR INTROLUCED IN OUTPUT FILE: '...2.....' TO 
l pane anee!* RC=S 

SEQUENCING OVERFLOW FOLLOWING SEC NUMBER*®......--' RC=8 
MISSING OH DUELICATE "MACS" CARD IN CONTROL FILE ‘fn ft fm'* 
RC=32 

MISSING PTF FILE 'fn ft fm* RC=12 

NO UPDATE FILES WERE FOUND RC=40 

SEQUENCE INCREMENT IS ZERO RC=8 

INVALID {CONTROL|{AUX} FILE CONTROL CARD kRC=32 

t./S * NOT FIRST CARI IN INPUT FILE --IGNORED RC=12 
INVALID CHAR IN SFQUENCE FIELD !.....c00c0e2' RC=12 

SEQUENCE NUMBER *...ce0ee-" NOT FOUND RC=12 

OPTION *SIK* INVALID WITHOUT 'CTL* RC=24 

INVALID UPDATE FILE CONTROL CARD RC=12 

INPUT FILE SEQUENCE ERRORS !.uwrwconee! TO "sccawweee!’ RC=4 
INSUFFICIENT SIORAGE TC COMPLETE UPDATE RC=41 

INSUFFICIENT STORAGE TO FEGIN UPDATE RC=41 
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XEDIT 


Use the XEDIT command to invoke the VM/SP System Product editor to 
create, modify, and manirfulate CMS disk files. Once the VH/SP Systen 
Product editor has keen invoked, you may execute XEDIT subcommands and 
use the EXEC 2 macro facility. 


You can return control to the CMS environment by issuing the XEDIT 
sukcommand FILE, QUIT or QQUIT. 


For complete details on kXEDITI subcommands and macros, see _ the 
publication VM/SP: System Product Editor Command and Macro Reference. 


The format of the XEDIT command is: 


XEDIT {fn [ft [£m]]] [ (options...[) ]] 


options: 
[ Width nnoj 


[ NOSCreen } 
[ PROFile macronaze ] 
[ NOPROFil]} 
[ NOCLear } 
options valid only in update node: 
[Update 
[ NOUpdate } 


iSeq8’ ] 
[ NOSeg8 ] 


[Ctl fn1] 
[Noctl ] 


[ Merge] 


[Incr no] 


ape ee oe See ee oe Ee ee oe oe ee Oe ee ee oe ee ee ee ee Ge ae Ee oe ee ee ee SE 
=e 6 oe ee ee ee ee oe eee oe ee ee eee eee ee eee ee Oe eee ee eee eee eee ee 


d 
| 
| 
l 
i 
l 
l 
l 
l 
l 
i 
l 
l 
1 
l 
l 
l 
l 
| 
l 
; 
l 
; 
i 
l 
l 
l 
| 


[ SIDcode string ] 


where: 

fn ft are the filename and filetype of the file to be edited. If 
they are not specified here, they must be provided in the LOAD 
subcommand as part of the profile. 

fn is the filemode of the file to be edited, indicating the disk 


on which the file resides. The editor determines the filemode 
of the edited file as follows: 


e Editing existing files 
When the filemode is specified, that disk and its 
extensions are searched. If the filemode is not specified 


or is specified as an asterisk (*), all accessed disks are 
searched for the specified file. 
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e Creating new files 


If the filemode is not specified, the editor assumes a 
filemode of Al. 


Options: 


Width non 
defines the amount of virtual storage used to contain one line 
of the file. If the value specified is too small, certain 
file lines may ke truncated. 


if not specified here, WiDTH may be defined in the LOAD 
subcommand, as a part cf the profile. If WIDTH 1s not 
specified in either the XEDII command or the LOAD subconmmand, 
the default is the larger of the following: 


e The logical record length (LRECL) of the file 


e The default ilcgical record length associated with the 
filetype 


NOSCreen 
forces a 3270 display terminal into line (typewriter) mode. 


PROFile macronane 
If the specified macro existS on one of the accessed disks, 
the editor executes it as the first subcommand. 


If the specified macro.is not found on an accessed CMS disk, 
an error message is displayed. 


-If this option is not specified but a macro with a macro name 
of PROFILE exists, the editor executes it. 


In all cases, the frofile macro must have a filetype of XEDIT. 


NOPROFil 
forces the editor not to execute the default PROFILE macro. 


NOCLE€ar 
Specifies that the screen is not cleared when the editor gets 
control. Instead, the screen is placed in a MORE... (waiting) 
Status. Any messageS remain on the screen until the CLEAR key 
1s pressed. This option is useful when the KXKEDIT command is 
issued from a macro that displays messages. 


The following options are meaningful only if the VM/SP System Product 
editor is to be used in update mode: 


Update 
The editor searches all accessed CMS disks for a file with a 
filename of fn and a filetype of UPDATE. If the file exists, 
the editor applies the update statements before displaying the 
file to be edited. Each new modification made by the user is 
added to the existing UPDATE file. The original source file 
is not nodified. 
If the file does not exist, the editor creates a new UPDATE 
file to contain modifications made by the user. 

NOUpdate 


specifies that the editor is to apply no update statements 
(even if UPDATE if specified in the LOAD subcommand in the 
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profile). 


Seq8 specifies that the entire sequence field (columns 73-80) 
contains an eight-digit seguence number in every record of the 
file to be edited. The SEQ8 option automatically forces the 
UPDATE option. SEQ8 is the default value. 


NOSeg8 
specifies that columns 73-75 contain a _ three-character label 
field, and that the sequence number is a five-digit number in 
columns 76-80. 


The NOSEQ8 option forces the UPDATE option. 


Ctl fn 
specifies that "f£n1l CNTRL" is an update control file that 
controls the application of multiple update files to the file 
to be edited. (See the CMS UPDATE command description for 
more information.) 


This option automatically forces the UPDATE and SEQ8 options. 


NOCtl specifies that the editor is not to use the control (CTL) file 
(even if it is specified in the LOAD subcommand in the 
profile). 


Merge specifies that all the updates made through the control file 
and all the changes made while editing will be written into 
the file whose name is defined by the latest update ievel 
(that is, the mast recently applied UPDATE file in a control 
file). This option forces the UPDATE option. 


Incr nn 
When inserting new lines in an update file, the editor 
automatically computes the serialization; the INCR option 
forces a minimum increment between two adjacent lines. If not 
Specified, the minimum increment is one (1). This option 
forces the UPDATE cpftion. 


SiIDcode string 
specifies a string that the editor inserts in every iine of an 
update file whether the update file is an existing file or if 
it 1s being created. The editor inserts the specified string 
in columns 64-71 and pads on the Cight with blanks, if 
necessary. Any data in columns 64-71 is overlaid. This 
option forces the UPDATE option. 


Usage Notes 


1. 


For the PROFILE, CIL, SIDCODE, and WIDTH options, the operand must 
be specified; otherwise, the next option will be interpreted as the 
operand. For example, in the “PROFILE hacroname"™ option, 
“"mMacroname" must be specified; if it is not, the next option will 
ke interpreted aS a acro name. 


Once the XEDIT command has been executed, the XEDIT subcommand can 
be used to edit and display nultiple files simultaneously. (See 
the XEDIT subcommand descripticn in the publication VM/SP: System 
Product Editor Command and Macro Reference). 


You can also call the editor recursively (using "CMS XEDIT...", for 
example). This ability is particularly useful when applications 
are developed using the editor and its macro facilities to 
interface with the user, for example, HELP. 
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4. If the editor is kept in virtual storage as part of the CMSSEG 
Shared segment, the CMS user area is unused. As a result, assuming 
a large enough virtual machine, any CMS or CP command may be issued 
directly from the editor environment itself (if a SET IMPCMSCP 
subcommand is in effect). Otherwise, the editor runs in the user 
area and only CMS and CP commands that run in the transient area 
may be issued from the editor environment. 


5. The following parameters are passed to the PROFILE macro when it is 
invoked by an XEDITI ccumand: 


e Everything fcllowing the command name is assigned to the 
EXEC 2 variakle &ARGSTRING. 
e Each parameter following the command name is assigned to an 


EXEC 2 argument (&1-6n). 


The editor does not examine any parameters that follow a 
closing right parenthesis on the XEDIT command. 


6. When you issue an XEDIT command for a variable-format file, 
trailing blanks are removed when the file is filed (or saved). 


7. Comment control records are deleted from an update file whenever an 
update file is applied to the original source file during an 
editing session, and a FILE or SAVE subcommand is issued. 

Responses: 


The following messages are displayed only if you are using the VM/SP 
System Product editor in upfdate mode: 


DMSXUP178I UPDATING 'fn ft fm". 
APPLYING "fn ft fm" 
APPLYING ‘fn ft fm' 


DMSXUP180W MISSING PIF FILE ‘fn ft fm'. 


Error Messages: 


DMSXINOO2E FILE 'fn ft £m* NCT FOUND RC=28 

DMSXINOO3E INVALID CFTICN ‘option RC=24 

DMSXINO24E FILE ‘*XEDTEMP CMSUT1 A1* ALREADY EXISTS kRC=28 

DMSXINO2Z9E INVALID PARAMETER ‘parameter’ IN THE OPTION ‘option! 
FIELD RC=24 

DMSXSUO48SE INVALID MODE ‘mode* RC=24 

DMSXINOSYE INCOMPLETE FILEIC SPECIFIED RC=24 

DMSXSU062E INVALID CHARACTER IN FILEID 'fn ft £m* kRC=20 

DMSXINO65E ‘option CFTICN SPECIFIEC IWICE RC=24 

DMSXINO66E toption' AND 'ortion' ARE CONFLICTING OPTIONS RC=24 

DMSXSUO69E DISK ‘mode NCI ACCESSED RC=36 

CMSXINO7OE INVALID PARAMETER ‘parameter' RC=24 

DMSXIN104S ERROR 'nn* READING FILE ‘fn ft fm" FROM DISK RC=100 

DMSXIN132S FILE 'fn £t £m" TCC LARGE RC=88 

DMSXSU229E ONSUPPORTED OS CATIA SET RC=80,81,82,83 

DMSXDS589E MISSING FILEDEF FCR CINAME SYSIN RC=32 

CMSXDSS9OE DATA SET TOC LARGE k&C=88 

DMSXDS591E OPEN ERROR ON SYSIN RC=32 3} 
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ELLOL messages with UPDATE opticns: 


DMSXUPOOVE FILE ‘fn ft fm' IS NCT FIXED, 80 CHAR. RECORDS RC=32 
DNSXUP174W SEQUENCE ERROR INTRODUCED IN OUTPUT FILE: '......-.' 10 

MS ack e ea ee RC=32 
DMSXUP179E MISSING OK DUPLICATE "MACS* CARD IN CONTROL FILE ‘fn ft fuo' 


RC=32 
DMSXUP183E INVALID aux/ctl FILE CONTRCL CARD RC=32 
DMSXUP184W *./S* NOT FIRST CARD IN UPDATE FILE -- IGNORED RC=32 


DMSXUP185W NON NUMERIC CHARACTER IN SEQUENCE FIELD *.......2-2' RC=32 
DMSXUP186W SEQUENCE NUMBER NCT FCUND RC=32 

DMSXUP207W INVALID UPDATE FILE CONTROL CARD RC=32 

DMSXUP210W INPUT FILE SEQUENCE ERROR *.......2.' TO ".s2e2e02' RC=32 
DMSXUP597E UNABLE TO MERGE UPDATES CONTAINING *./ S* CARDS RC=32 


0 Normal 


6 Subcommand rejected in the profile due to LOAD error 
20 Invalid character in filename or filetype 
24 Invalid parameters, cr ofticns 
28 Source file net fcund (UPDATE MCDE) or file XEDTEMP 
CMSUT1 already exists 
32 Error during updating frocess 
36 Corresponding disk not accessed 
88 File is too large and does not fit into storage 
100 Error reading the file inte storage 
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Immediate Commands 


You can issue an Immediate command from the terminal only after causing 
an attention interruption by pressing the Attention key (or its 
equivalent). These commands are processed as soon as they are entered. 
The HT and RT Immediate commands are also recognized when they are 
stacked in an EXEC frocedure, and the HT Immediate command can be 
appended to aCMS command preceded by a logical line end symbol (#). 
Any program execution in progress is suspended until the Immediate 
command is processed. 


Ncne of the Immediate commands issue responses. 


HB 


Use the HB command to stop the execution of a CMS batch virtual machine 
at the end of the current joh. ‘The format of the HB Immediate command 
is: 


Usage Notes 


1. If the batch virtual machine iS running disconnected, it must be 
reconnected. 


2- When the HB command is executed, CMS sets a flag such that at the 
end of the current job, the batch processor generates accounting 
information for the current jok and then logs off the CMS batch 
virtual machine. 


HO 


Use the HO command during the execution of a command or one of your 
programs to stop the recording of trace information. Program execution 
continues to its normal cogpleticn, and all recorded trace information 
is spooled to the printer. The format of the HO command is: 
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HT 


Use the HT command to suppress all terminal output generated by any CMS 
command or your program that is currently executing. The format of the 
HT command is: 


Usage Notes 


1. Program execution continues. When the ready message is displayed, 
normal terminal outpwt resumes. Use the RT command to restore 
typing or displaying. 


2. CMS error messages having a suffix letter of S or T cannot be 
suppressed. 


HX 


Use the HX command to stop the execution of any CMS or CMS/DOS command 
Or program, close any open files or I/O devices, and return to the CMS 
command environment. ‘The format of the HX command is: 


Usage Notes 


1. HX clears all file definitions made via the FILEDEF or DLBL 
commands, including those entered with the PERM option. 


2. The HX command is executed when the next SVC or I/0 interruption 
occurs: therefore a delay may occur between keying HX and the 
return to CMS. All terminal output generated before HX is 
processed is displayed before the command is executed. 


3. HX does not clear user storage. 


RO 


Use the RO command, during the execution of a command or one of your 
programs, to resume the recording of trace information that was 
temporarily suspended by the SO command. Program execution continues to 
its normal completion, and all recorded trace information is spooled to 
the printer. The format of the RO command is: 


Gg a ae ee ty eT, Rete TP eee 1 
| RO | I 
a ee a a a ep a 
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RT 


Use the RI command to restore terminal output from an executing CMS 
command or one of your frograms that was previously suppressed by the HT 
command. The format of the RT command is: 


1 kT | i 


Usage Note 


Program execution continues, and displaying continues from the current 
point of execution in the progran. Any terminal output that is 
generated after the HIT ccmmand is issued and up to the time the RT 
command is issued is lost. Execution continues to anormal progran 
completion. 


sO 


Use the SO command during the execution of a command or one of your 
programs to temporarily suspend the recording of trace information. 
Program execution continues to its normal completion and all recorded 
trace information is spooled to the printer. The format of the SO 
command is: 


Usage Note 


To resume tracing, issue the RO command. 
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Section 3. EDIT Subcommands and Macros 


This section describes the formats and operands of the EDIT subcommands 
and macros. EDIT subcommands are valid only in the environment of the 
CMS editor or in CMS editor compatibility mode, which is invoked with 
the EDIT command. The EDII command format is described in "Section 2. 
CMS Commands." 


The editor has two modes of operation: edit mode and input mode. 
Whenever the EDIT command is issued, edit mode is entered; when the 
INPUT or REPLACE subcommands are issued with no operands, input mode is 
entered. In input mode, all lines you enter are written into the file 
you are editing. To return to edit mode from input mode, you must enter 
a null line (one that has ne data on it). 


For a functional description of the CMS editor and information on how 
to use it, consult the VM/SP CMS User's Guide. 


For a functional description of CMS editor compatibility mode and 
information on how to use it, see the EDIT command in this book and the 
VM/SP: System Product Editor Ccmmand and Macro Reference, "Appendix B". 


For a summary of the default settings assumed by the editor for CMS 
reserved filetypes, see "Appendix A: Reserved Filetype Defaults." 


EDIT Subcommands 


The EDIT subcommands are listed in alphabetical order for easy 
reference. Each subcommand description includes the format, a list of 
operands (if any), usage notes, and responses. For those subconmands 
that operate somewhat differently on a 3270 display terminal than ona 
typewriter terninal, an additional discussion, "Display Mode 
Considerations, " is added. 


Subcommands that are valid only with 3270 display terminals, namely 
SCROLL, SCROLLUP, and FORMAT have the notation "(3270 only)" next to the 
subcommand names. The FORWARD and BACKWARD subcommands, which were 
designed for use with 3270 terminals but can be issued at any terminal, 
have the notation "(primarily 3270)" next to the subcommand names. 
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ALTER 


Use the ALTER subcommand to change a specific character to another 
Character, one that may not be available on your terminal keyboard. The 
ALTER subcommand allows you to reference characters by their hexadecimal 
values. The format of the ALTER sutconmmand is: 


r 
Charl char2 ] 
| 
i 


bes mm es ee 
bee ee ee = a 


where: 

Charl Specifies the character to be altered. It may be specified 
either as a single character or aSa pair of hexadecimal 
digits (00 through FF). 

char2 specifies the character to which charl is to be altered. It 
May be specified either as a single character or as a pair of 
hexadecimal digits. 

D indicates the number of lines to be searched for the specified 
character. If you specify an asterisk (*), ail lines in the 
file, beginning with the current line, are searched. If this 
option is omitted, then only the current line is searched. 

G requests the editor to alter every occurrence of charl in the 


lines specified. If G or * is not specified, only the first 
occurrence of charl in each line specified is altered. 


Usage Notes 
1. If char2 is a héexadécimal value that cannot ke represented on your 
terminal, it may appear as a blank, for example: 
input XSLC 
alter X 02 
SLC 


Column 1 contains an X'02', which cannot be displayed. 


2. Use the ZONE subcommand if you want only particular columns 
searched for a specific character. 


Responses 


When verification is on, altered lines are displayed at your terminal. 
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Display Mode Considerations 


When you reyguest a global change on a 3270, the display is changed only 
once, to reflect the final fosition of the current line pointer. The 
editor displays a message to indicate the number of lines changed: 


ed LINE (S) CHANGED 
NO 


AUTOSAVE 


Use the AUTOSAVE subcommand to set, reset, or display the automatic save 
function of the editor. When the automatic save function is in effect, 
the editor automatically issues the SAVE subcommand each time the 
specified number of changes or insertions are made. The format of the 
AUTOSAVE subcommand is: 


4 ior 1 | 
| AUTOSave | ja | | 
l | JOFF| | 
1 i & as | 
om a a a eee 
where: 

n is a decimal number between 1 and 32767, indicating the 
frequency of the automatic save function. One SAVE subcommand 
is issued for every n lines that are changed, deleted, or 
added to the file. 

OFF turns off the automatic save function. This is the initial 


setting. 


1. Each line affected by the $MOVE macro is treated as one update. 
However, all changes caused by a single CHANGE, DELETE, DSTRING, 
GETFILE, or OVERLAY subkcommand are treated as a_ single update, no 
matter how many lines are affected. 


2- If you are editing a file on a read-only disk, and an automatic 
Save request occurs, the message: 


SET NEW FILEMODE AND RETRY 
is issued. You can enter CMS subset and access the disk in 
read/write mode, or use the FMCDE subcommand to change the filemode 
to the mode of a read/write disk. If you were in input mode, you 
are placed in edit mode. 


3. The message "SAVED" is displayed at the terminal each time the save 
Operation occurs. 
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RESPONSES 


If you issue the AUTOSAVE sukcommand with no operands, the editor 
displays the current setting of the automatic save function. 


BACKWARD (Primarily 3270) 


Use the BACKWARD subcommand to move the current line pointer towards the 
beginning of the file ycu are editing. The format of the BACKWARD 
sukcommand is: 


aE PE a 
EE / 
loa 5 
m= AZ 
foe oe ee, Oe 


n is the number of records ktackward you wish to nove the current 
line pointer. If n is not specified, the current line pointer 
is moved backward one line, toward the top of the file. 


sage Note 


The BACKWARD subcommand is eguivalent to the UP subcommand; it is 
provided for the convenience of 3270 users. 


Responses 


When verification is on, the current line on the screen contains the 
record located by the BACKWART n value. If n exceeds the number of 
records above the current line, TOF is displayed on the current line. 


On a typewriter terpinal the new current line is typed if 
verification is on. 
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BOTTOM 


Use the BOTTOM subccmmand to make the last line of the file the new 
current line. The format of the BOTTCM subcommand is: 


a re LON Te he ae ae eT I ee Ce ET EE GP Ee EE SP Ee eG ST EL ee ee ee 
| Botton | { 
[a a ae ee a Pa a ae ee TT | 
Usage Note 


Use the BOTTOM subcommand followed Ey the INPUT subcommand to begin 
entering new lines at the end of a file. 


esponses 


When verification is on, the last line in the file is displayed. 


If the BOTTOM subcommand is issued at a 3270 display terminal in display 
mode, EOF: is displayed on the line following the current line, preceded 
by the last records of the file; the rest of the screen's output area is 
blank. 


CASE 


Use the CASE subcommand to indicate how the editor is to process 
uppercase and lowercase letters. The format of the CASE subcommand is: 


e=—s 
— = 

be oe oe od 

— oe oe oe ol 


where: 

M indicates that the editor is to accept any mixture of 
uppercase and lowercase letters for the file as they are 
entered at the terninal. 

U indicates that the editor is to translate all lowercase 


letters to uppercase letters before the letters are entered 
into the file. Uis the default value for all filetypes 
except MEMC and SCRIPT. 
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Responses 


If you enter the CASE subcommand with no operand, the current setting is 
displayed at the terminal. 


Display Mode Considerations 


If you specify CASE MH when uSing a 3270 that does not have the lowercase 
feature (RPQ), you can key in lowercase characters, but they appear on 
the screen aS uppercase characters. 


CHANGE 


Use the CHANGE subcommand to change a specified group of characters to 
another group of characters of the same ora different length. You may 
use the CHANGE subcommand to change more than one line at atime. The 
format of the CHANGE subcommand is: 


oe ee ee ce ee ee ee ee es es es es es ee ss i es es es es es es es es ee es es es es ee ss es ee ss i i ee es a es oe 


where; 


/ (diagonal) signifies any unique delimiting character that does not 
appear in the character strings involved in the change. 


string! specifies a group of characters to be changed (old data). 
string! may be a null string. 


string2 specifies the group of characters that are to replace 
stringi (new data). Sstring2 may be a null string; if 
omitted, it is assumed null. 


nh or * indicates the number of lines to be searched, starting at 
the current line. If * is entered, the search is performed 
until the end of the file is reached. If this option is 
Omitted, then only one line is searched. 


G or * requests the editor to change every occurrence of string! 
in the lines specified. if G or * is not specified, only 
the first occurrence of stringl in each line specified is 
changed. If string1 is nuil, G or * may not be specified. 
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Usage Notes 


1. 


The first nonblank character following the CHANGE subcommand (or 
any of its truncations) is considered the delimiter. For example: 


c.VM/SP.CMS.* 


changes the first occurrence of VM/SP to CMS on every line from the 
current line to the end of the file. 


If string2 is omitted, it is assumed to be a null string. For 
example: 


THIS ISN THE LINE. 
Change /n 
THIS IS THE LINE. 


A null string causes a character deletion. If stringi is null, 
Characters are inserted at the beginning of the line. For example: 


THIS IS THE LINE. 
Change //sSoO / 
SO THIS IS THE LINE. 


To change multiple cccurrences of the same string on one line, 
enter: 


change/string1/string2; 1 * 


The CHANGE subcommand can be used on typewriter terminals to 
display, without changing, any lines that contain the information 
Specified in string1. Enter: 


change /stringl/stringly * * 


Use the ZONE subcommand to indicate which columns are to be 
searched for string1. If string1l is wider than the current zone, 
you receive the message: 


ZONE ERROR 


and you should either reenter the CHANGE subcommand or change the 
zone setting. 


If the character string inserted causes the data line to extend 
beyond the truncation column or the zone column, any excess 
Characters are truncated. (See the description of the TfRUNC 
subcommand for additional infcrmation on truncation.) 


You should use the ALTER sukcommand when you want to change a 
Single character to some special character (one that is not 
available on your keykoard). 


When the IMAGE subcommand is set with the CANON operand, backspace 
Characters at the beginning cr end of stringl1 are ignored. 


To stack a CHANGE subcommand with no operands from a fixed-length 
EXEC, you should use the &STACK control statement. 
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Responses 


When verification is on, every line that is changed is displayed. 


Display Mode Considerations 


If you issue the CHANGE sukcommand without operands at a 3270 display 
terminal in display mode, the following occurs: 


1. The record pointed to Fy the current line pointer appears in the 
user input area of the display. If the line is longer’ than the 
current truncation setting, it is truncated. 


2- You can then alter the record in the user input area by retyping 
part or all of the line, or by using the Insert, Delete, or Erase 
EOF keys to insert or delete characters. 


3. When the line is modified, press the Enter key. This causes the 
record in the user input area to replace the old record at the 
current line in the qutput display area. 


If you bring a line down to the user input area and decide not to 
change it, press the Erase Input key and then the Enter key, and the 
line is not changed. 


When aline is moved to the user input area, all nonprintable 
characters (including tabs, backspaces, control characters, and _ so on) 
are stripped from the line. Also, any characters currently assigned to 
VM/SP logicai line editing symbols (#, @, ¢, ") are reinterpreted when 
the line is reentered. You should issue an explicit CHANGE subcommand 
to change lines containing special characters. 


The CHANGE subcommand is treated as an invalid subcommand if it is 
issued without operands at a typewriter terminal or at a 3270 display 
terminal that is not in display mode. 


When you reguest a glokal change on a 3270 terminal, the display is 
changed only once, to reflect the final position of the current line 
pointer. The editor displays, in the message area of the display 
screen: 


{10} LINE(S) CHANGEL 
NO 


to indicate the number of lines that were updated. If the change 
reguest resulted in the truncation of any lines, the message is 
displayed as: 
nnonn LINE(S) CHANGED nnnn LINE(S) TRUNCATED 
If the change request moves the current line pointer beyond the end 


of the file, the word EOF: is displayed on the current line, preceded by 
the last records of the file. The rest of the output area is blank. 
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CMS 


Use the CMS subcommand to cause the editor to enter the CMS subset node, 
where you may execute those CMS ccmmands that do not need to use the 
Main storage being used by the editor. The format of the CMS subconmmand 
is: 


ee ae ae a Le eT ee ee We ee ete ae ee ee Cee oe ee 7 
| CAS | l 
[| re | 
Usage Notes 


1. In CMS subset, you can execute any CMS command that is 
nucleus-resident or that executes in the transient area. The 
nucleus-resident CMS commands are: 


CP GENMOD NAMEFIND 
DEBUG INCLUDE START 
ERASE LOAD STATE 
EXECIO LOADMOD STATEW 
FETCH 


The commands that may be in the transient area are: 


ACCESS HELP RELEASE 
ASSGN LISTIFILE RENAME 
COMPARE MODMAP SET 

DISK OPTION SVCTRACE 
DLBL PRINT SYNONYM 
FILEDEF PUNCH TAPE 
GENDIRT QUERY TYPE 
GLOBAL READCARD 


To return to edit mode, use the CMS subset command RETURN. 


2- If you attempt to execute a CMS command that requires main storage, 
you receive the message: 


INVALID SUBSET CCMMANDL 


Results are unpredictable at this point. You should not attempt to 
execute any program that executes in the user program area. Using 
the LOAD, INCLUDE (RESET), FETCH, START, and RUN commands could 
load programs that would overlay the editor's storage area and its 
contents. Use these commands only for programs that execute in the 
transient area. 


3. In an edit macro, if you attempt to use a command that is invalid 
in the CMS subset, you receive a return code of -0002. 


4. If you attempt to execute a CMS command that fails because of 
insufficient storage, your EDIT session may abnormally terminate. 
You should save input you have entered before you enter CMS subset 
node. 


S- Combining EDIT and XEDIT, such as executing XEDIT as a CMS Subset 


Command of EDIT, may not give you the INVALID SUBSET message, but 
it can result in abends or unpredictable results. 
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Usage Note 


The zone set by the ZONE subcommand or the default zone setting is 
checked for the presence of the character string. A character string 
with a length greater than the current zone setting causes’ the error 
message ZONE ERROR. 


Responses 


If the character string is not found by the end of the file, no 
deletions occur, the current line pointer is unchanged, and the message: 


STRING NOT FOUND, NO DEIETICNS MADE 


is displayed. 


Display Mode Considerations 


If verification is on when the DSTRING subcommand is issued at a display 
terminal in display mode, the screen is changed to reflect the deletions 
from the file. 


FILE 


Use the FILE subcommand to write the edited file on disk and, 
optionally, override the file identifier originally supplied in the EDIT 
command. The format of the FILE sukcommand is: 


ee ns ee BI Pag ee ee Re TaN a ps TR eg ne ee, ae eng aE EEE Opt g See ee oe 
| FILE | {fin [ft [fnj]} | 
i a 


where: 

fn indicates the filename for the file. If filename is onitted, 
filetype and filemode cannot be specified, and the existing 
filename, filetyre, and filemode are used. 

ft indicates the filetype for the file. 

fn indicates the filemode for the file. 


Usage Notes 


1. When you specify a file identifier, any existing file that has an 
identical fileid is replaced. If the file being edited had been 
previously written to disk, that copy of the file is not altered. 


2. You can change the filename and filemode during the editing session 
uSing the FNAME and FMOLE subconmmands. 


Responses 


The CMS ready message indicates that the file has been written to disk 
and control is returned to the CMS environment. 
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FIND 


Use the FIND subcommand to locate a line based on itS initial character 
String. The format of the FIND subcommand is: 


aS A a a a A SE a a RT | 
| Find | [line] l 
i a ee 


line is any character string, including blanks and tabs, that you 
expect to find beginning in column 1 of an input record. At 
least one nonklank character must be specified. If line is 
not specified or the line contains only blanks, the current 
line pointer is moved down one line. 


Usage Notes 
1. Only one blank can be used asa delimiter following the FIND 
Subcommand; additicnal Elanks are considered part of the character 

string. 


2. If the image setting is ON, the editor expands tab characters to 
the appropriate number of Llanks before searching for the line. 


3. If the current line fecinter is at the bottom of the file when the 
FIND subcommand is issued the search begins at the top of the file. 
Responses 


When verification is on, the line is displayed at the terminal. If the 
line is not found, the message: 


EOF: 


is displayed and you may use the REUSE (=) subcommand to search again, 
keginning at the tog of the file. 


FMODE 


Use the FMODE subcommand to display cr change the filemode of a file. 
The format of the FMODE sukccnmmand is: 


fo indicates the filemode that is to replace the current filemode 
setting. You can specify a filemode letter (A-Z) or a 
filemode letter and number (0-5). If you specify a filemode 
letter, the existing filemode number is retained. 
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Usage Notes 

1. The specified filemode is used the next time a FILE, SAVE, or 

automatic save reguest is issued. If the file being edited had 

been previously filed or saved, that copy of the file remains 
unchanged. 


2. If the disk specified by filemode already contains a file with the 
Same filename and filetype, that file is replaced when a FILE, 
SAVE, Or automatic save reguest is issued; no warning message is 
issued. 


3. If the fFilemode specified is that of a read-only disk, then when an 
attempt is made tc file or save the file, the editor displays an 
error message. 

Responses 


If you enter the FMODE subcommand without specifying fm, the editor 
displays the current filenode. 


Display Mode Considerations 


When you specify a new filemode with the FMODE subcommand, the editor 
writes the new filemode in the filemode field at the top of the screen. 


FNAME 


Use the FNAME subcommand to display or change the filename of a file. 
The format of the FNAME sukcommand is: 


Gr ee eS Re Oe Sa BG FE rae Sw a ag Re ee Ee ee ee ee ee Se ee 
| FNane | [fo] | 
ea a acer ce ee ee 


where: 


fn indicates the filename that is to replace the current 
filename. 


Usage Notes 


1. The specified filename is used the next time a FILE, SAVE, or 
automatic save request is issued. If the file being edited had 
been previously filed or saved, that copy of the file remains 
unchanged. 


2. If a file already exists with the specified filename and the same 
filetype and filemode, that file is replaced; no warning message is 
issued. 


3. You can use the FNAME subcommand when you want to make nultiple 


copies of a file, with different filenames, without terminating 
your edit session. 
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Responses 


If you enter the FNAME subcommand without specifying fn, the editor 
displays the current filenane. 


Display Mode Considerations 


When you issue the FNAME subcommand specifying a new filename, _ the 
editor writes the new name in the filename field at the top of the 
screen. 


FORMAT (3270 only) 


Use the FORMAT subcommand to change the mcde of a local or remote 3270 
terminal from display to line or line to display mode. The format of 
the FORMAT subcommand is: 


a ee ene en ed eT gee te ey eet ee epee Oe SG GE Oe Vege eet age Tage Me ah EY OG Na ee gee 1 
| FORMat | DISPLAY | 
| j LINE | 
ne a a ne ee a we ne oe a a es a ee ee a J 
wneres 


DISPLAY specifies that a full screen display of data is to occur. 
Subcommands do not appear as part of the data displayed. 


LINE Specifies that the display station is to operate as a 
typewriter terminal. Every line you enter is displayed on the 
screen; the screen looks like a typewriter terminal's console 
sheet. 


sage Notes 


1. Line mode is the default for remote 3270s. If you are using a 
remote 3270 in display mode, and you enter the INPUT subconmmand, 
you are placed in line mode while you enter input. When you return 
to edit mode, the full screen display is restored. 


2- The FORMAT subcommand is treated as invalid under any of the 
following conditions: 


ae The NODISP oftion of the EDIT command was used to invoke the 
editor. 


b. The edit session was initiated on a typewriter terminal. (The 
session may ofticnaily be continued on a 3270 after a 
reconnection.) 


To obtain a full screen display, you must save your file and 
restart your edit session. 


3. The column settings for the VERIFY, TRUNC, and ZONE subconmmands 
remain unchanged when you issue the FORMAT subcommand. 
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EDIT Subcommands~FORWARD 
Responses 


None. 


FORWARD (Primarily 3270) 


Use the FORWARD subcommand to move’ the current line pointer towards the 
end of the file you are editing. The format of the FORWARD subcommand 


Gee ged ee Oe ag eg ee ey ee ee ee ee ey > te | 
i lr { 
| FOrward 1 juni l 
| 1 idl l 
l [oA | 
Dm mn ne ae en a a a a we a a a a a a wn a a an a a a a a a a a a rw wr nr wr ee ee J 
where: 

n is the number of records you wish to move forward in the file 


being edited. If n ig not specified, 1 is assumed. 


Usage Note 


The FORWARD subcommand is eguivalent to the DOWN and NEXT subcommands; 
it is provided for the convenience of 3270 users. 


Responses 


When verification is on, the new current line is displayed. If the 
number specified exceeds the number of lines remaining in the file, the 
current line pointer is positioned at EOF:. 
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GETFILE 


Use the GETFILE subcommand to insert all or part of a specific CMS file 
into a file you are editing. The format of the GETFILE subcommand is: 


cr i | 
l l c. Ff. *.. r a4 ( 
| Getfile | ec jfm |firstrec |numrec|]|]| | 
i i t* i* {«* jd1 | * Aid 
| | L L L L J433J \ 
Le ee — oe ee we ee ee ee ee oe ew a we ee oe ee a ee wr ee oe ee ee a we ew ee oe we oe we = oe J 
where: 

fn is the filename of the file that contains the data to be 


inserted into the file you are editing. When an asterisk (*) 
is specified, the filename of the file you are editing is 
assumed. 


ft is the filetype cf the file that contains the data to be 
inserted. If ft is not specified or when an asterisk (*) is 
specified, the filetype of the file you are editing is 
assuned. 


fn is the filemode of the file that contains the data to be 
inserted. If fm is not specified or when an asterisk (*) is 
specified, all of your accessed disks are searched for the 
file. 


firstrec indicates the number of the first record you want to copy. 


nhuprec indicates the numker of lines tc be inserted, starting with 
the line specified by firstrec. If numrec is not specified, 
or specified as *, then the remainder of the file between 
firstrec and the end of the file is inserted. 


Usage Notes 


1. The GETFILE operand list is positional; if you omit one operand, 
you cannot specify any operands that follow. Thus, if you want to 
specify firstrec and ilastrec, you must specify the filetype and 
filemode of the file. 


2- The last line inserted becomes the new current line. 


3. If the length of the records in the file containing the data to be 
inserted exceeds that of the file being edited, an error message is 
displayed, and the GETFILE is not executed; if shorter, the records 
are padded to the record length of the file being edited and 
inserted in the file. 


4. If you use the GETFILE subcommand to insert lines into a VSBASIC 
file, use the RENUM sukcommand to resegquence the file. 


5. If the editor fills up available storage while executing a GETFILE 
reguest, it may not be able to copy all of the file. You should 
determine how many records were actually copied, and then write the 
current file on disk. 
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Responses 


When verification is on, the last line inserted into the file is 
displayed. If the end of the file has been reached, the message: 
EOF REACHED 


is displayed, followed by the display of the last line inserted. 


IMAGE 


Use the IMAGE subcommand to control how the editor should handle 
kackspaces and tab characters or to display the current image setting. 
The format of the IMAGE subkcommand is: 


= 

| lc 1 [ 

{ IMAGE i JON | | 

i | (OFF | | 

l | JCANON] i 

I (== z l 

ee a a a a a a a a a a a a a a a a a a nn a a nn ner ree ee J 

where: 

ON specifies that any text entered while in input mode or asa 
line of data following a FIND, INPUT, OVERLAY, or REPLACE 
subcommand, is expanded into a line image; backspaces are 
-removed and taks are replaced by blanks. 

Text entered in the form of delimited strings, as in CHANGE, 
LOCATE, and ALTER, is not expanded; tabs and backspaces are 
treated in the same way as cther characters. 

IMAGE ON is the default for all filetypes except SCRIPT. 

OFF Specifies that tabs and backspaces are treated as data 
Characters in the same way as other characters. They are not 
deleted, translated, expanded, or reordered. 

CANON specifies that Eackspaces may be used to produce compound 


characters such as undersccred words, headings, or phrases. 
Before they are inserted in the file, compound characters are 
ordered, with backspaces arranged Singly between the 
characters that overlay each other; the overlaying characters 
are arranged according to their EBCDIC values. Tab characters 
are handled as for IMAGE OFF. 


CANON is the default for SCRIPT files. 


Usage Notes 


1. When the image setting is ON, tab characters are expanded to an 
appropriate number of Llanks, according to the current settings of 
the TABSET subcommand. The TABSET command has no effect if the 
image setting is either OFF or CANON. 
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2. When the image setting is on, backspaces are handled as follows: 


e Backspace characters act ina similar manner to the logical 
character delete symbol, in deleting the previous characters if 
a sufficient number of cther characters or blanks follow the 
backspace characters. However, backspace characters that 
immediately follow a command name are interpreted as separator 
characters and do not delete any part of the command nane. 


e If a backspace character is the last character in the input 
line, it is ignored. 


Responses 


When you issue the IMAGE sukcommand with no operand, the current IMAGE 
setting is displayed. 


INPUT 


Use the INPUT subcommand to insert a single line into a file, or, if no 
data line is specified, to leave edit mode and enter input mode. The 
format of the INPUT subccmmand is; 


| Input | [line] | 
Uw ns a a a a a a a a a a rrr wr nee ee | 
where: 

line pecifies the input line to be entered into the file. It can 


contain blanks and tabs; i1f you enter at least two blanks 
following the INPUI sukcommand and no additional text, a blank 
line is inserted into the file. 


Usage Notes 
1. Each line that is inserted into the file becomes the new current 
line. 
2. When you are using line-number editing (LINEMODE LEFT or LINEMODE 
RIGHT) you cannot use the INPUT subcommand to insert a single line 


of data; use the nnnon subcommand. 


3. To stack an INPUI Subcommand in order to enter input mode froma 
fixed-length EXEC, you should use the &STACK control statement. 
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Responses 


When you issue the INPUT subcommand without operands, and verification 
is on, the editor displays: 


INPUT: 


All subsequent lines you entered are written into the file, until you 
enter a null line to return to edit node. 


Display Mode Considerations 


1. When you insert lines while using a local display terminal in 
display mode, the editor writes each record on the current line. 
The old current line and all records above it move up one line, 
except for the topmost record formerly on line 2, which is deleted 
from the screen. 


2. If you are using a remote display terminal in display mode and you 
issue the INPUT subcompand with no text, the terminal is forced 
into line node. The display of the file on the screen disappears 
and the word INPUT: appears. AS you enter input lines, they appear 
in the output display area. When you leave input mode by entering 
a null line, the remote terminal returns to display mode. The 
display of the file reappears on the screen, with the lines you 
have just entered in their proper place in the file. 


3. When you are entering data in input mode at a display terminal that 
is in line mode, a tab character generated by a program function 
(PF) key only generates one character, and appears aS one character 
on the screen. That is, the line does not appear spaced according 
to the tab settings. 


LINEMODE 


Use the LINEMODE sukcommand to set, cancel, or display the status of 
line-number editing. When you use line-number editing, you can input, 
locate, and replace lines by referencing their record numbers. 
Line-number editing is the default for VSBASIC and FREEFORT files. The 
format of the LINEMODE sukconmand is: 


Go ee a ee ea 1 
| lr 1 l 
| LINEnode J |JLEFT | l 
l { |RIGHT| i 
| [| JOFF | { 
| { ¢ 4 ( 
ieee ee eae So Soe So oe ee ee a J 
wneres 


LEFT initializes line-nunber editing and places sequence numbers 

L on the left, in columns 1 through 5, right-justified and padded 
with blanks; the near zone is set to 7. If the filetype is 
FREEFORT, columas 1 through 8 are used for serial numbers; the 
hear zone is set to 9. 
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You should never use left-handed line-number editing for files ina 
which data must occupy columns 1 through 6, for example ASSEMBLE 
files. 


RIGHT initializes line-number editing aad places sequence numbers 
R on the right, in columns 76 to 80, right-justified and padded 
with zeroes. The end zone and truncation columns are set to 72. 


This operand is valid only for files with fixed-length 
80-character records. 


OFF cancels line-numker editing and (if you were using left-handed 
line-number editing) resets the first logical tab setting to 
column 1.2 The VERIFY, TROUNC, and ZONE subcommand settings remain 
unchanged. Serialization may still be in effect. OFF is the 
default for all filetypes excerpt VSBASIC and FREEFORT. 


Note: If you enter LINEMODE OFF while editing a FREEFORT file, 
line-number editing cannot te resumed for the remainder of the 
edit session. 


Usage Notes 


1. When you enter input mode while you are uSing line-number editing, 
you are prompted with a line number to enter each line. The 
default prompting increment is 10; you may change it using the 
FROMPT subcommand. 


If you enter input mode after using the nnnnon subcommand to 
position the current line pointer, the prompted line number is the 
next higher multiple cf the current frompting increment or an 
adjusted line number, whichever is smaller. The adjusted line 
number is determined according to the following fornula: 


Pppp = 1 + cccc + _pnnn - cccc (Any fractional remainder is 


4 dropped.) 
where: 
Pppp is the prompt line number. 
cccc is the current line nunter. 
nnnn is the next sequential line number in the file. 


2. When you are prompted on a typewriter terminal, enter your input 
line on the same line as the frompted line number. If you are 
uSing right-handed line-number editing, on a typewriter terminal or 
on a display terminal in line mode, the serial numbers are not 
redisplayed in columns 76 to 80 (unlesS you use the VERIFY 
subcommand to increase the verification setting). When a line is 
displayed in edit mode, the line numbers always appear on the left 
even though they are on the right in the disk copy of the file. 
Whether or not the line numbers are displayed on the right depends 
on the current verification setting. 


3. You cannot use the INPUT or REPLACE subcommands to input a Single 


data line when you are using line-number editing; use the nnnnn 
subcommand instead. 


Section 3. EDII Subcommands and Macros 381 


EDIT Subcommands-LINEMODE, LCCATE 


4. When you initialize line-number editing for files that already 
exist, the editor assumes that the records are in the proper format 
and numbered in ascending order. 


5. If you want to place serial numkers in columns 76 through 80, but 
you do not wish tc use line-number editing, use the SERIAL 
subconmmand. 


Responses 


When you issue the LINEMODE subcommand with no operands, the current 
setting is displayed. 


When you use line-oumber editing on a display terminal in display mode, 
the prompting numbers in input mode appear on line 2 of the display 
screen, in the editor message area. Enter your input lines in the user 
input area. Regardless of whether ycu are using fright- or left-handed 
line-number editing, the line numbers always appear in their true 
position in the file. 


LOCATE 


Use the LOCATE subcommand to scan the file beginning with the next line 
for the first occurrence of a specified character string. The format of 
the LOCATE subcommand is: 


We a aa ee ge ee ae Pe ee ge es ee ee ee ee Ge ee ee 
|[ Locate] | /[string[/ ]} l 
| ee ee a ee ee ee ee ee eee | 
where: 

/ (diagonal) Signifies any unique delimiting character that does not 


appear in the string. The delimiter may be any nonblank 
Character. The closing delimiter is optional. 


string specifies any group of characters to be searched for in 
the file. 
Usage Notes 


1. If the beginning delimiter is /, you can omit the subcommand name 
LOCATE. If you enter only: 


/ 
on a line, the current line pointer is moved dcwn one line. 
2. if string is null or Elank, the search is successful on the first 
line encountered. If the line fointer is at the end of the file 


when the LOCATE subcommand is issued, scanning starts from the top 
of the file. 
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3. Use the ZONE subcommand when you want the editcr to search only a 
specific column. If you specify a character string longer than the 
current zone width, the editor issues the message ZONE ERROR. 

Responses 


When verification is on, the line containing the specified string is 
displayed. If the string is not found, the messages: 


NOT FOUND 
EOF: 


are displayed, and you may use the REUSE (=) subcommand to request that 
command be repeated, beginning at the top of the file. 


LONG 


Use the LONG subcommand to cancel a previous SHORT subcommand reguest. 
The format of the LONG sukcommand is: 


| LONG i i 


Usage Note 


When the LONG subcommand is in effect (it is the default), the editor 
responds to invalid subcommands with the message: 


PEDIT: line ... 


Responses 


None. 


NEXT 


Use the NEXT subcommand to advance the line pointer a specified number 
of lines toward the end of the file. The line pointed to becomes the 
new current line. The format of the NEXT subcommand is: 


D indicates the number of lines to move the line pointer. If _ nan 
is omitted, then the fointer is moved down only one line. 
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Usage Note 


NEXT is equivalent to DOWN and FORWARD. 


Responses 


When verification is on, the new current line is displayed. If the end 
of the file is reached, the message: 


EOF: 


is displayed. 


OVERLAY 


Use the OVERLAY subccmmand to selectively replace one or more character 
strings in the current line with the corresponding nonblank characters 
in the line being keyed in. The format of the OVERLAY subcommand is: 


ep a OE Gg ete eh a ee Ne RE OP Re ee ee Ee OTE Ge eS Ee ae pO ae eT ee ee 
| Overlay | [line] | 


line Specifies an input line that replaces corresponding character 
positions in the current line. On a typewriter terminal, if 
you enter the OVERLAY subcommand with no data line, the input 
record remains unchanged. 


Usage Notes 


1.2 Blank characters in the input line indicate that the corresponding 
characters in the current line are not to be overlaid. For 
example: 


CHARMIE 
fe) L 
CHARLIE 


Blanks in columns 3, 4, 5, and 6 of the OVERLAY line indicate that 
columns 1, 2, 3, and 4 of the current line are not to be changed. 
(At least one flank nust follow the OVERLAY subcommand, which can 
be truncated as OQ). 


2. This subcommand may be entered at a typewriter terminal by typing 
the letter "o", followed by a Ltackspace, followed by the overlaying 
characters. This sets up the correct alignment on the terminal. 


3. An underscore in the overlaying line must be used to place a blank 
into the corresponding position of the current line. Thus, an 
underscore cannot be placed (or replaced) in a line. 


OVERLAY should be used with care on lines containing underscored 
words or other compound characters. 
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4. To perform a global overlay operation, issue the REPEAT subcommand 
just prior to issuing the OVERLAY subcommand. For example, when 
you enter: 


repeat * 
overlay X 


an X is placed in the leftmost cclumn of each frcecord in the file, 
beginning with the current line. The leftmost column, for files 
with the IMAGE setting ON, is determined by the first logical tab 
setting. 


When verification is on, the line is displayed at the terminal after it 
has been overlaid. 


Display Mode Considerations 


In addition to using the OVERLAY subcommand in the normal way, you may 
also issue the OVERLAY sukcommand with no operands. The next line you 
enter is treated as overlay data. To cancel the overlay request, press 
the Erase Input key and then the Enter key. 


PRESERVE 


Use the PRESERVE subcommand to save the settings of various EDIT 
subcommands until a subsequent RESTORE subcommand is issued. The format 
of the PRESERVE subcommand is: 


Deh eee ag ee RE a Sie Se eT GE Te IPT ee Fe nn RN Ee Can IN Ne ee nay ee 
| PREserve | | 
ee nee ee oP ee A Ee ee ee ee | 


Usage Note 


Settings are saved for the following subcommands: 


CASE LONG TABSET 
FMODE PROMPT TRUNC 
FNAME RECFM VERIFY 
IMAGE SERIAL ZONE 
LINEMODE SHGRT 

Responses 

None. 
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PROMPT 


Use the PROMPT subcommand to change the prompting increment for input 
line numbers when you are using line-number editing. The format of the 
PROMPT subcommand is: 


= 
aoe oe ool 


where: 

n Specifies the frompting increment; the default value is 10. 
The value of n should not exceed 32,767. 

Responses 


When you issue the PROMPT subcommand with no operands, the current 
setting is displayed. 


QUIT 


Use the QUIT subcommand to terminate the current editing session and 
leave the previous copy of the file, if any, intact on the disk. The 
format of the QUIT subcommand is: 


a ne ee ey ore eg ee a eee we ee ye eee EN ee, ee ee ee ay, aT Pe 
| QUIT | i 


| | 


Usage Notes 


1. You can use the QUIT subcommand when you have made a global change 
that introduced errors into your file; or whenever you discover 
that you have made errors in editing a file and want to cancel your 
editing session. 


If a SAVE subcommand or automatic save request has been issued, the 
file remains as it was when last written. 


2- The QUIT subcommand is a convenient way to terminate an edit 
session when you enter an incorrect filename on the EDIT command 
line, or when you edit a file merely to examine, but not to change, 
its contents. 


Responses 


The CMS ready message indicates that control has been returned to CMS. 
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RECFM 


Use the RECFM subcommand to indicate to the editor whether the record 
format of the file is fixed-length or variable-length, or to display the 
current RECFM setting. The format cf the RECFM subcommand is: 


ae eee Oo Ee 


where: 
F indicates fixed-length records. 
V indicates variable-length records. 


Usage Notes 


1. %V as assumed by default for all new EXEC, LISTING, FREEFORT, 
VSBDATA, and SCRIPT files. Usually, a variable-length format file 
occupies a smaller amount of disk space because trailing blanks are 
deleted from each line before it is written onto disk. When 
variable-length UVSEDATA files are written to disk, however, 
trailing blanks are nct truncated (to allow VSBDATA file to Span 
records). 


2. When you use the RECFM subcommand to change the format of a file 
from fixed-length tc variable-length records, trailing blanks are 
removed when the file is written to disk; when you are changing 
variable-length records to fixed-length, all records are padded to 
the record length. 


Responses 


When you use the RECFM subccmmand without specifying F or V, the current 
setting is displayed. 


When you specify a new record format with the RECFM subcommand, the 
editor writes the new record format in the format field at the top of 
the screen. 
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RENUM 


Use the RENUM subcommand to recompute the line numbers for VSBASIC and 
FREEFORT source files. The format of the RENUM subcommand is: 


i l rc r 11 | 
| RENum | [strtno jJincrno| | | 
i i | 10 Istrtno| | I 
{ | L L J J J 


strtno indicates the number from which you wish to start renumbering 
your file. Because RENUM renumbers the whole file from 
beginning to end, the numkter you specify as strtno becomes the 
Statement number of the first statement in the newly 
renumbered file. This number may not exceed 99999 for VSBASIC 
files or 99999999 for FREEFORT files. The default start 
number value is 10 and the specified start number must not be 
Zero. 


incrno indicates the increment number value by which you wish to 
renumber your file. This value may not exceed 99999 for 
VSBASIC files or 99999999 for FREEFORT files. The default for 
imcrno is strtno, the first seguence number in the renumbered 
file, and the specified incrno must not be zero. 


Usage Notes 


1. If you do not specify strtno and incrno, the default value for both 
is 10. If you specify only strtno, incrno defaults to’ the same 
value as strtno. 


2. The current line pointer remains aS it was before you entered the 
RENUM subcommand regardless cf whether or not RENUM completes 
successfully. If you are editing a VSBASIC file, the file to be 
renumbered must €ither originate from a read/write disk or you must 
issue an FMODE subcommand to change the file destination to a 
read/write disk. 


3. All VSBASIC statements that use statement numbers for operands are 
updated to reflect the new line numbers. The VSBASIC statements 
with line number oferands are: 


CLOSE If READFILE 
CLOSEFILE ON REREADFILE 
DELETE OPEN RESET 

EXIT OPENFILE RESETFILE 
GET FRINT USING REWRITEFILE 
GOSUB PUT WRITEFILE 
GOTO 


4. If any error occurs during the RENUM operation, the editor 
terminates the RENUM operation and the file being edited remains 
unchanged. 


388 IBM VM/SP CMS Command and Macro Reference 


EDIT SubcommandS-RENUM, REPEAT 


Responses 


When verification is on, the message EDIT: indicates that the RENUM 
subcommand completed processing. 


REPEAT 


Use the REPEAT subcommand to execute the immediately following OVERLAY 
subcommand (or an X or Y subcommand assigned to invoke OVERLAY) for the 
specified number of lines or to the end of the file. The format of the 
REPEAT subcommand is: 


[md 3% 


here: 


n indicates the number of times to repeat the OVERLAY request that 
immediately follows, beginning with the current line. An asterisk 
(*) indicates that the request is to be repeated until the end of 
the file is reached. If neither n nor * is specified, then only 
one line is handled. The last line processed becomes the new 
current line. 


DPsage Notes 
1. If the next subcommand issued after the REPEAT subconmand is not an 
OVERLAY subcommand, the REPEAT subcommand is ignored. 


2. For an example of a REPEAT subcommand followed by an OVERLAY 
subcommand, see the discussion of the OVERLAY subcommand. 


Responses 


None. 
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REPLACE 


Use the REPLACE subcommand to replace the current line with a specified 
line or to delete the current line and enter input mode. The format of 
the REPLACE subcommand is: 


De ot OE ST ee ee TET Gee ee Ap ga ew Ne te ee RG, ee ye ea ee aor Pate 


| Replace | [iine] | 


where: 

line specifies an input line that is to replace the current line. 
If a line is specified, then the editor puts it into the file 
in place of the current line. If no line is specified, the 


editor deletes the current line and enters input mode (see 
Usage Note 2 for exception). 


Usage Notes 


1. If the LINEMODE subcommand with a LEFT oc RIGHT operand is in 
effect, then issuing the REPLACE subcommand specifying a line is 
not valid. If the REPLACE subcommand is used without any operands 
when LINEMODE is set to LEFT or RIGHT, you are prompted for the 
next available line number; the first data line you enter replaces 
the current line number. 


2. If, you use the REPLACE subcommand with no operands’ to enter input 
mode, and the next line you enter is a null line, then the current 
line is not deleted, and you are returned to edit mode. 


3. To stack a REPLACE subcommfand in order to enter input mode from a 
fixed-length EXEC, you should use the &STACK control statement. 


Responses 


When verification is on and you issue the REPLACE subcogmand with no 
data line, the message: 


INPUT: 


indicates that your virtual machine is in input node. 
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RESTORE 


Use the RESTORE subcommand to restore the settings of EDIT subcommands 
to their values when the PRESERVE subcommand was last issued or to their 
default values if a PRESERVE subcommand has not been issued. The format 
of the RESTORE subcommand is: 


oa ee a a ye 
| REStore | ( 
_ ee | 
Usage Note 


The settings are restored for the following subcommands: 


CASE LONG TABSET 
FMODE FROMPT TRUNC 
FNAME RECFM VERIFY 
IMAGE SERIAL ZONE 
LINEMODE SHORT 


Responses 


None. 


RETURN 


Use the RETURN subcommand to return to edit mode from the CMS subset 
environment. RETURN is not an EDIT subcommand, but is listed here as a 
companion to the CMS subcommand. The format of the RETURN command is: 


rr eg rn me ee a Be a Pee Fee ae Reg Ng eT OD NG EL Bay eee eye eee a gee ee ee ee ee 
| RETURN | l 


ae a eee 


Responses 


When verification is on, the editor responds: 
EDIT: 


to indicate that your virtual machine is in edit node. 
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Use the REUSE subcommand (which can also be specified as =) to stack 
last in, first out (LIFO) the last EDIT request, except for REUSE or a 
question mark, and then execute the stacked subcommands. The format of 
the REUSE (or =) subcommand is: 


Oe rg ee ee ee Se Le ee ta ey he Se Fee pg ee = ee rege eee ee ee ee oe ee 
i oo | [subcommand] i 
LAS l l 
a ie a ee 


where: 


subcommand specifies any valid EDIT subcommand. 


Usage Notes 


1. If the subcommand you enter on the REUSE subcommand line is an 
invalid subcommand, the editor clears the stack. 


2. You can use the REUSE subcommand to repeat a subcommand request 
that was not satisfied the first time, for example, a LOCATE 
subconmmand that resulted in an end-of-file condition. If you 
enter: 


the LOCATE subcommand is stacked, then read by the editor and 
executed again. This time the search begins from the top of the 
file. 


3. You can also enter more than one equal sign (=) on a single line, 
to stack the last issued subcommand more than once. For example; 


locate /xyZ/ 
XYZ IS MY FAVORITE 


I FIRST MET XYZ 

XYZ'*S NAME IS DERIVED 
LAST SAW XYZ 

EOFs: 


the LOCATE subconmmand is stacked four times, and then the editor, 
reading from the stack, executes the four stacked subcommands. 


4. You can do the following if you issue a CHANGE subcommand before 
positioning your current line pointer: 


C/XX/YY 
NOT FOUND 
= 1/x/ 
LINE XXXX 
LINE YYXX 


In this example, the CHANGE request was issued and stringl was not 
found. The REUSE subcommand stacks the CHANGE subcommand and 
stacks a LOCATE subcommand in front of it. The LOCATE subcommand is 
read and executed, fcllowed by the CHANGE subcommand. 
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5. You can stack an INPUT or REPLACE subcommand in front of a data 
line you mistakenly entered in edit mode, for example: 


roses are red, violets are blue 

ZEDIT: ROSES ARE RED, VIOLETS ARE BLUE 
= input 

INPUT: 

without cms 

i would be, too. 


The = subcommand stacks the INPUT subcommand in front of the data 
line. Reading from the stack, the editor executes the INPUT 
subcommand, then reads in, as the first line of data, the line 
beginning with ROSES. The file contains: 


ROSES ARE RED, VIOLETS ARE BLUE 
WITHOUT CMS 
I WOULD BE, TOO. 


Responses 


Responses are those that are issued to the stacked subcommands. 


SAVE 


Use the SAVE subcommand to write the file that is currently being edited 
onto the disk, without returning control to CMS, and optionally to 
change the file identifier. The format of the SAVE subcommand is: 


| SAVE | (fn [ft [fm ]])] : 

where: 

fn indicates the filename of the file to be saved. If you 
Specify only fn, then the filetype and filemode are the same. 

ft ndicates the filetype of the file to be saved. 

fn indicates the filemode of the file to be saved. 


Usage Notes 


1. If you specify a new file identifier, any existing file with the 
same file identifier is replaced; no message is issued. The file 
being edited, if previously written to disk, is not altered. 


2. To write a file on disk and terminate the editing session, use the 
FILE subcommand. 


3. If you want to save the contents of a file at regular intervals, 
use the AUTOSAVE subcommand. 
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Responses 
When verification is on, the editor displays: 
EDIT: 


to indicate the SAVE request completed successfully and you may continue 
to enter EDIT subcommands. 


SCROLL/SCROLLUP (3270 only) 
Use the SCROLL and SCROLLUP subcommands to scan the contents of a file 
on a display screen. 

SCROLL causes the editor to scan forward through the file; SCROLLUP 


causes the editor to scan backward through the file. The format of the 
SCROLL and SCROLLUP subcommands is: 


| { 
| eee \ j ja 
| (Scroll JUL p]$ | * 
| i ji 
| l 


n is a number from 1 to 255 that specifies the number of 
Successive screens of data to be displayed. If an asterisk 
(*) is specified, the entire file, from the current line to 
the end or beginning of the file, is displayed. If nis not 
specified, 1 is the default. 


Usage Notes 


1. The SCROLLUP subcommand can be specified by any combination of the 
truncation of SCROLL and UP; the mininun truncation is SU. 


2- The number of lines shifted forward or backward depends on the 
current verification setting. If the verification setting is 80 
characters or less, then a scroll request displays a file in 
increments equal to the number of lines that can be displayed in 
the output display area of the screen. If the verification setting 
is more than 80 characters, then a SCROLL request displays a file 
in increments equal to half the number of lines that can be 
displayed in the output area. 


Therefore, a single SCROLL on a 3270 Model 2 display terminal is 
the equivalent of DOWN 20 or DOWN 10, depending on the’ record 
length, and SCROLLUP is the equivalent of UP 20 or UP 10. 


3. When you use the SCROLL or SCROLLUP subcommands to display nore 
than one screenful, each display is held for one minute, and the 
screen status area indicates MORE... . To hold the screen display 
lcnger, press the Enter key. 
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To halt scrolling before all the requested screenfuls are 
displayed, enter the HT Immediate command and press the Cancel key 
twice. 


4. When you begin scrolling from the top of the file, the first 
screenful contains only the first seven lines. When you scroll to 
the end of the file, the last screen may duplicate lines displayed 
in the previous screen. 


Responses 


The screen display is shifted forward or backward. 


SERIAL 


Use the SERIAL subcommand to control the serialization of records in 
columns 73 through 80. The format of the SERIAL subcommand is; 


cr a | 

| SERial | ( OFF | 

{ d rc 1 l 

| {| <ON fincr] | 

l | JALL [10 | | 

| | \segq t 4 4 

a we oe oe ee ee ee ae es a a = a a oe ee = ae = ee = = ee ee ee ee a a = ee ee ee J 

where: 

OFF indicates that neither serialization numbers nor identifiers 
are to be placed in columns 73-80. 

ON indicates that the first three characters of the filename are 
to be used in columns 73-75 as an identifier. 

ALL indicates that columns 73-80 are to be used for serialization 
humbers. 

seq specifies a three-character identification to be used in 
columns 73-75. 

incr specifies the increment for the line number in columns 76-80 


(or 73-80). This number also becomes the first line number. 
If incr is not specified, then 10 is assumed. 
Usage Notes 
1. The SERIAL subcommand is valid only for files with fixed-length, 
80-character records. To renumber VSBASIC or FREEFORT files, use 


the RENUM subconmand. 


2- The serialization setting is ON, by default, for the following 


filetypes: 
ASSEMBLE PLI 
COBOL PLIOPT 
DIRECT UPDATE 
FORTRAN UPDTxxxx 
MACRO 
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3. When serialization is in effect, records ina file are resequenced 
each time a FILE, SAVE, or AUTOSAVE request is issued. If you are 
uSing line-number editing, you must issue the subcommand: 

linenode off 
before issuing a FILE or SAVE subcommand if you wish the records to 
be resequenced. 


Responses 


If you issue the SERIAL subcommand in a file with a zone column greater 
than 72, the message: 


END ZONE SET TO 72 
is displayed, to indicate that the zone has been changed. If the zone 
column is 72 or less, but the truncation column is greater than 72, the 
message: 


TRUNC SET TO 72 


is displayed. 


SHORT 


Use the SHORT subcommand to reguest the editor to respond to invalid 
subcommand lines with the short form of the ?EDIT message. The format 
of the SHORT subcommand is: 


ee a ge me ey BP Be fe ne Ben eG OR eee gE ee GM 
| SHORT | ; 


me a re rr pe i i nd 


Usage Notes 
1. When the SHORT subcommand is in effect, the editor responds: 
to an invalid subcommand line, and responds: 
a$ 
to an invalid macro reguest. 


2. To resume displaying the long form. of the ?7EDIT message, use the 
LONG subcommand. 


Responses 


None. 
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STACK 


Use the STACK subcommand to stack data lines or EDIT subcommands in the 
console stack for subseguent reading. The format of the STACK 
subcommand is: 


ubconnand 


l= ON bp 
ta ee ee oe oe 


lr 
il 
| 
ii 
I | 
poe 


n indicates the number of lines to be stacked beginning with 
the current line. If anumber or ae subconmmand is not 
specified, then one line is assumed by default. A maxinun 
of 25 lines can be stacked. 


If the current line pointer is at the top of the file, then 
n-1 lines are stacked. If fewer than n lines remain in the 
file, only the lines remaining are stacked. 

subcommand specifies an EDIT subcommand to be stacked. 


0 stacks a null line. 


Usage Notes 


1. STACK subcommands are used to write edit macros, to stack lines 
from a file so that they can be moved around, or to. stack 
additional subcommands. 


2. All lines stacked with the STACK subcommand are stacked FIFO (first 
in, first out). 


3. The length of input lines that are stacked is determined by the 


current TRUNC' setting. The maximum length, however, is_ 130 
characters. 
Responses 


None. If you issue the STACK subcommand to stack an EDIT subcommand 
line, the stacked subcommand is executed immediately; responses are 
those to the stacked subcommands, if any. 
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TABSET 


Use the TABSET subcommand to set logical tab stops for a file. The 
format of the TABSET subcommand is: 


|] TABSet J} ni [n2 ..- non] | 
| | | 


where: 

ni [n2... nnj] indicates column positions for logical tab settings. You 
May specify up to 25 numbers, separated from each other 
by at least one blank. ni indicates the first column in 
the file that may contain data. 

Usage Notes 

1. The editor assigns the following tab settings by default: 
Filetypes Default Tab Settings 


ASM3705, ASSEMBLE, 1, 10, 16, 31, 36, 41, 46, 69, 72, 80 
MACRO, UPDATE, 


UPDTxxxx 

AMSERV 2, 6, 11, 16, 21, 26, 31, 36, 41, 46, 51, 
61, 71, 80 

FORTRAN 1, 7, 10, 15, 20, 25, 30, 80 

FREEFORT 9, 15, 18, 23, 28, 33, 38, 81 

BASIC, VSBASIC 7, 10, 15, 20, 25, 30, 80 

PLIOPT, PLI Doty. Te AO, 13 ¢ 165. 19% 227. 25,. 31, 37; 
43, 49, 55, 79, 80 

COBOL 1, 8, 12, 20, 28, 36, 44, 68, 72, 80 

Others 1, 6, 11, 16, 21, 26, 31, 36, 41, 46, 51, 


61, 71, 81, 91, 101, 111, 121, 131 
2. Tab setting operands have no effect if the IMAGE subcommand's 
Operand is either OFF or CANON. (CANON is the default for SCRIPT 
filetypes). A tab entered into a file under these conditions 
appears as X'05*. 


3. The margins set by the TABSET subcommand are used by the INPUT, 
REPLACE, OVERLAY, and FIND subcommands. 


Responses 


None. 
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TOP 


Use the TOP subcommand to move the line pointer to the top of the file. 
The null top line becomes the current line. The format of the TOP 
subcommand is: 


Cea ae NS eee ag Pe ae RE eS Se ee ae Wan, eT GPE ge PET Cy pee eh OO Nee, ae ee ee al 
{ TOP { l 


Rn a a n,n ge Re a ee I a ee ee ee) 


Responses 
When verification is on, the message: 


TOF: 


is displayed. 


Display Mode Considerations 


When you are using a display terminal, if you specify TOP and 
verification is on, the current line (see Figure 29) contains the 
characters TOF (indicating the top of the file), the lines preceding it 
are blank, and the rest of the screen's output display area contains the 
first lines of the file. 


TRUNC 


Use the TRUNC subcommand to change the truncation column of records or 
to display the current truncation column setting. The format of the 
TRUNC subcommand iss: 


n indicates the column at which truncation is to occur. If n is 
specified as an asterisk (*), the truncation column is set to 
the record length for the filetype. 

Usage Notes 


1. The editor assigns the following truncation setting by default: 


Filetypes Truncation Column 
ASSEMBLE, MACRO, UPDATE, UPDTxxxx 71 
AMSERV, COEOL, DIRECT, FORTRAN, 
PLI, PLIOPT 72 
All Others Record Length 
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2. The truncation value is used by the INPUT, REPLACE, STACK, and 
OVERLAY subcommands also, and, for display terminals in display 
mode, the CHANGE subcommand when it is used with no operands. 


3. If your virtual machine is in input mode and you enter a line that 
is longer than the current truncation setting, the message: 


TRUNCATED 
is displayed along with a display of the truncated line. Your 
virtual machine is still in input mode. 
Responses 


When you enter the TRUNC subcommand with no operands, the editor 
displays the current setting. 


TYPE 


Use the TYPE subcommand to display all or any part of a file at the 
terminal. The format of the TYPE subcommand is: 


be ee ee oe ol 
fas ee ee es nd 


m indicates the number of lines to be displayed, beginning with 
the current line. An asterisk (*) indicates all lines between 
the current line and the end of the file. If m is omitted, 
only one line is displayed. If the number of lines specified 
exceeds the number remaining in the file, displaying stops at 
the end of the file. 


D indicates the column at which displaying is to stop, 
overriding the current end column for verification. . If n is 
specified as an asterisk (*), it indicates that displaying is 
to take place for the full record length. 


Usage Notes 


1. Use the TYPE subcommand to display lines when you are editing a 
file with verification off. 


2. If you display one line, the current line pointer does not move; if 
you display more than one line, the current line 1s positioned at 
the last line displayed, or at the end of the file if you specified 
an asterisk (*). 


3. If you have set an end verification columa to a value less than the 
record length, and you want to display an entire record, enter: 


type 1 * 
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4. If you do not specify an end column, the length of the 1line(s) 
displayed is determined by the current end verification setting. 
If you are using right—handed line-number editing on a typewriter 
terminal or a display terminal in line mode, the line numbers are 
displayed on the left. 


Responses 


The requested lines are displayed. 


Display Mode Considerations 


Since the TYPE subcommand was designed for printing terminals, it is of 
Marginal value ona display terminal, except when you use line mode. 
However, if the display screen is interrupted by communication from the 
control program (CP), you should use the TYPE subcommand to restore the 
full screen display. 


UP 


Use the UP subcommand to reposition the current line pointer toward the 
beginning of the file. The format of the UP subconmmand is: 


where: 

n indicates the number of lines the pointer is to be noved 
toward the beginning of the file. If a number is not 
Specified, then the pointer is moved up only one line. The 
line pointed to becomes the new current line. 

Usage Note 


UP is equivalent to BACKWARD. 


Responses 

When verification is on, the line pointed to is displayed at your 
terminal. if the UP subcommand causes the current line pointer to nove 
beyond the beginning of the file, the following message is displayed: 


TOF: 
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VERIFY 


Use the VERIFY subcommand to set or display the current verification 
setting. The format of the VERIFY subcommand is: 


lore 
N ill 
FFI [1 J l = l 
J LL J 4 


where: 

ON specifies’ that lines located, altered, or changed are 
displayed, and changes between edit and input mode are 
indicated. ON is the initial setting. 

OFF specifies that lines that are located, altered, or changed are 
not displayed, and changes retween edit and input mode are not 
indicated. 


Sstartcol indicates the column in which verification is to begin, when 
verification iS on. The default is column 1. #£4startcol nust 
not be greater than the record length nor greater than endcol. 


endcol indicates the last column to be verified, when verification is 
on. endcol must not be greater than the record length. If 
endcol is specified as an asterisk (*), each record is 
displayed to the end of the record. 


Usage Notes 
1. If you issue the VERIFY subcommand with only one operand, that 


operand is assumed to be the endcol operand. For example, if you 
issue VERIFY 10, verification occurs in columns 1 through 10. 


2. The editor assigns the following settings, by default: 


Filetypes Verification End Column 
AMSERV, ASSEMBLE, COBOL, Column 72 


DIRECT, FORTRAN, MACRO, 
PLI, PLIOPT, UPDATE, UPDTxxxx 
Others (Including FREEFORT) Record Length 


Responses 
If you issue the VERIFY subcommand with ano operands, the current 


Sstartcol and endcol settings are displayed, regardless of whether 
verification is on or off. 


402 IBM VM/SP CMS Command and Macro Reference 


EDIT Subcommands—X, Y 


Xory 


Use the X or Y subcommands to assign a given EDIT subcommand to be 
executed whenever X or Y is entered, or to execute the previously 
assigned subcommand a specified number of times. The format of the X 
and ¥ subcommands is: 


lor 
{ | subconmmand 
| jan 
i ii 
{ ¢& 


| 


where: 


subcommand indicates any EDIT subcommand line. The editor assumes that 
you have specified a valid EDIT subcommand, and no error 
checking is done. 


n indicates the number of times the previously assigned 
subcommand is to be executed. If X or Y is entered with no 
operands, 1 is assumed. 


Usage Notes 


1. Advancement of the current line pointer depends upon the EDIT 
subcommand that has been assigned to X or Y. If a number ora 
subcommand is not specified, the previously assigned subcommand is 
executed once, 


2- X and Y are initially set to null strings. If you enter X or Y 
without having previously assigned a subcommand to it, the editor 
issues the ?EDIT error nessage. 

3- You can use the X and ¥ Subcommands in many instances where you 
must repeat a subcommand line many times while editing a file, but 
the situation does not lend itself to a global request. For 
example, if you assign X to a LOCATE and Y to a CHANGE subcomnmand, 
issue; 

x 
to execute the LOCATE request, and after examining the line, you 
can Change it and continue searching, by entering the Y subcommand 
followed by tae X sukcommand: 

y#x 
Or just continue searching: 


x 


Responses 


Responses are issued for the EDIT subcommands that are assigned to X and 
Y, in accordance with the current verification setting. 
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ZONE 


Use the ZONE subcommand to specify the columns of each record (starting 
position and ending position) to be scanned when the editor searches for 
a character string or to display the current ZONE settings. The format 
of the ZONE subcommand is: 


l i ©. r 11 ; 
| Zone | |firstcol |[lastcol] | | 
| i |* [* il l 
( 1 11 | il | 
| | L L diJ | 


where: 
firstcol indicates the near zone column of each record to be scanned. 


If firstcol is specified as an asterisk (*), the default is 
column 1. 


lastcol indicates the end zone column of each record to be scanned. 
If lastcol is specified as an asterisk (*), the default is the 
record length. 


Usage Notes 


1. The editor assigns the following settings by default: 


Filetypes Near Zone End Zone 
(Column) (Column) 
ASSEMBLE, MACRO, UPDATE, 71 


UPDTxxxx 


AMSERV, PLI, PLIOPT 2 72 
COBOL, DIRECT, FORTRAN 1 72 
BASIC, VSBASIC 7 Record Length 
FREEFORT 9 Record Length 
Others 1 Record Length 


2. The ZONE settings are used by the ALTER, CHANGE, and LOCATE 
subcommands to define the columns that will be scanned. If you 
specify a character string longer than the zone, you receive the 
message: 

ZONE ERROR 
and the subcommand is not executed. 


3. If you issue a CHANGE subcommand that increases the length of a 
line beyond the end zone setting, the line is truncated. 
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4. You can use the ZONE subcommand to protect data in particular 
columns, for example: 


edit newfile nemo 
NEW FILE: 
EDIT: 
zone 
1 80 
zone 10 20 
input the zone is now set for columns 10—20 


EDIT: 
change /0/*/ 
the zone is n*w set for columns 10—20 


Note that the LOCATE and CHANGE subcommands operated on the word 
now, not the word zone, because scanning started in position 10, 
not in position 1. 


Responses 


When you enter the ZONE subcommand without specifying zone settings, the 
editor displays the current setting. 


? (QUESTION MARK) 


Use the ? subcommand to display the last EDIT subcommand executed except 
for a REUSE (=) or ? (question mark) subcommand. The format of the ? 
subcommand is: 


TE yn ge a ee Fe TO Oe Ge eG ee ee ee ee ee ee 7 
| ? 
SS ee ee a ee 


Usage Note 
After anxXx, Y, or = subcommand, the last EDIT subcommand is the 


Subcommand that was executed aS a result of issuing the X or Y 
subcommand. 


Display Mode Considerations 


When you issue the ? subcommand using a 3270 in display mode, the last 
EDIT subcommand that was executed is redisplayed in the user input area. 
Press the Enter key to execute it again; you may modify the line before 
reentering it. 
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nnnnn 


Use the nnonnon subcommand to enter and iocate lines when you are using 
line-number editing. The format of the nnnnon subcommand is: 


| f/mnonn | [text] i 
nonnnnnan | | 


where: 

nnann indicates a line number between 0 and 99999 if the filetype is 
BASIC or VSBASIC, or a line numker between 0 and 99999999 if 
the filetype is FREEFORT. 

text specifies a line of text to be inserted into the file at the 
specified line number. If a line with that number already 
exists, it is replaced. If no text line is specified, the 
Current line pointer is positioned at the line number 
specified. 

Usage Note 


The nnnnn subcommand is valid only when you are using line-number 
editing; that is, you have issued the LINEMODE subcommand using the 
RIGHT or LEFT operand. Line-number editing is the default for VSBASIC 
and FREEFORT files. 


Responses 


When you issue the nnonnn subcommand with no operands, the iine with the 
specified line number is displayed. If the line is not found, the 
editor displays the message: 

LINE NOT FOUND 


and the current line pointer is set at the largest line number that does 
not exceed annnn. 
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EDIT Macros 


Edit macros are CMS EXEC files that execute seguences of EDIT 
subcommands. The following edit macros are supplied with VM/SP for your 
convenience. For additional information on creating and invoking your 
own edit macros and EXEC files, see the VM/SP CMS User's Guide. 


$DUP 


Use the $DUP to duplicate the current line. The format of the $DUP 
macro is: 


Ios 
ee | 


n indicates the number of times you want to duplicate the line; 
the maximum value you can specify is 25. If n is omitted, the 
current line is duplicated once. 


Usage Notes 
1. The last copy of the line duplicated becomes the new current line. 
2. If you use the logical line end symbol (#) to stack additional 
Ssubcommands on the same line with the $DUP edit macro those 
subcommands are cleared from the console stack and the message: 
STACKED LINES CLEARED BY $DUP 


is issued. The stacked subcommand(s) are not executed. 


3. Because it uses console functions, $DUP cannot be used when 
duplicating records containing binary zeros or nonprintable 
Characters. Truncated duplicate records will result. 


4. When using line-number editing, you can insert duplicate lines 
between existing numbered lines if the interval between line 
Qhumbers is large enough. Execution of $DUP stops after the last 
valid line number has been assigned. You can renumber your file to 
increase the interval between line numbers. 


5. Because it uses the STACK EDIT subcommand, $DUP can duplicate a 
Maximum of 130 characters in one line. Longer lines are truncated. 


Responses 


The last line duplicated (the new current line) is displayed. 
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$MOVE 


Use the $MOVE edit macro to move one or more lines from one place in a 


file to another place. The format of the $MOVE macro is: 


where: 

n indicates the number of records you want to move, beginning 
with the current line. The maximum number of lines you can 
move is 25. 

UP o indicates that you want to move the lines toward the top of 
the file, mf lines above the current line. 

DOWN o indicates that you want to move the lines toward the end of 


the file, m lines Lrelow the last line you are going to move. 


TO label indicates that you want the lines inserted following 


the 


specified label. The label must be one to eight uppercase 


characters and must start in column 1. 


Usage Notes 


1. The last line noved becomes the new current line. 


2. If the label is not found or if the DOWN value exceeds the number 
of lines remaining before end of file, the lines are inserted at 
the end of the file. If the UP value exceeds the number of lines 
remaining before top of file, the lines are inserted at the top of 


the file. 


3. If you use the logical line end symbol (#) to stack additional 
subcommands on the same line with the $MOVE request, those 


subcommands are cleared from the console stack and the message: 
STACKED LINES CLEARED BY $MOVE 


is displayed. The stacked subcommands are not executed. 


4. Because it uses console functions, $MOVE will truncate duplicated 


records containing LFinary zeros or nonprintable characters. 


5. Because it uses the STACK EDIT subcommand, $MOVE can move a maxilun 


of 130 characters in one line. Longer lines are truncated. 


Responses 


When verification is on, the last line noved is displayed. 
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Section 4. Debug Subcommands 


This section describes the subcommands that are available to you when 
you use the debug environment to test and debug your programs. The 
debug environment is entered when: 


e The DEBUG command ig issued from the CMS environment. (The DEBUG 
command is described in "Section 2. CMS Commands.") 


e An external interruption occurs. (An external interruption is caused 
by the CP EXTERNAL command.) 


e A breakpoint (instruction address stop) is encountered during program 
execution. (Breakpoints are set with the DEBUG subcommand BREAK.) 


When the debug environment is entered, the contents of all general 
registers, the channel status word (CSW), and the channel address word 
(CAW) are saved so they may be examined and changed before being 
restored when leaving the debug environment. If debug is entered via an 
interruption, the old program status word (PSW) for that interruption is 
also saved. If DEBUG is the first command entered after an abnormal 
termination (abend) occurs, the contents of all general registers, the 
CSW, the CAW, and the old PSW are available from the time of the abend. 


For hints on debugging your programs uSing the CMS debug environment, 
consult the VM/SP CMS User's Guide. 
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BREAK 


Use the BREAK subcommand to stop execution of a program or module at a 
specific instruction location called a breakpoint. The format of the 
BREAK subcommand is: 


SS SS SS 
| BReak | id {symbol { 
l l hexloc { 


where: 

id is a decimal number, from 0 to 15, which identifies the 
breakpoint. A maximum of 16 breakpoints may be in effect at 
one time; if you specify an identification number that is 
already set for a breakpoint, the previous breakpoint is 
cleared and the new one is set. 

symbol is a name assigned to the storage iocation where the 
breakpoint is set. symbol, if used, must have previously been 
set using the DEFINE subcommand. 

hexloc is the hexadecimal storage location (relative to the current 


Origin) where the breakpoint is to occur. hexloc must be ona 
halfword boundary and its value added to the current origin 
must not exceed your virtual machine size. 


Usage Notes 


1. To set breakpoints before beginning program execution, enter the 
debug environment with the DEBUG command after you load the progran 
into storage. After setting the breakpoints, use the RETURN 
subcommand to leave the debug environment and issue the START 
command to begin program execution. For example: 


load myprog 
debug 

break 1 20016 
break 2 20032 
return 

start 


2. When you assign hexloc to a breakpoint, you must know the current 
Origin (set with the ORIGIN subcommand). The hexloc you specify is 
added to the current origin to determine the breakpoint address. 

3. When a breakpoint is found during program execution, the message: 


DMSDBG728I DEEUG ENTERED BREAKPOINT yy AT xxxxxx 


is displayed at the terminal. To resume program execution, use the 
GO subcommand. 


4. Breakpoints are cleared after they are encountered; thus, if a 
breakpoint is encountered during a program locp you must reset the 
breakpoint if you want to interrupt execution the next time that 
address is encountered. 


5. When you set a breakpoint, the halfword at the address specified is 
replaced with B2Ex, where x represents the identification number 
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you assigned. After the breakpoint is encountered during 
execution, B2ZEx is replaced with the original operation code. 


6. You should set breakpoints only at valid operation code addresses; 
the BREAK subcommand does not check to see whether or not the 
specified location contains a valid operation code. 


7. If you reference a virtual storage address that isin a shared 


segment, you are given a nonshared copy of the segment and you 
receive the nessage: 


SYSTEM sysname REPLACED WITH NON-SHARED copy 


Responses 


None. 


CAW 


Use the CAW subcommand to display at the terminal the contents of the 
CAW (channel address word) as it existed at the time the debug 
environment was entered. The format of the CAW subcommand is: 


Usage Notes 


1. Issue the CAW subcommand to check that the command address field 
contains a valid CCW address, or to find the address of the current 
CCW so you can examine it. 


2. The three low-order bits of the command address field must be zeros 
in order for the CCW to be on a doubleword boundary. If the CCW is 
not on a doubleword boundary or if the command address specifies a 
location protected from fetching or outside the storage of a 
particular user, the Start I/O instruction causes the _ status 
portion of the CSW (channel status word) to be stored with the 
program check or frotection check bit on. In this event, the I/0 
operation is not initiated. 


Responses 


The CAW, located at storage location X'48', is displayed. Its format is: 


i a ee ee 
| KEY | 0000 | Command Address | 


[ae ee eS a ee ee a ee a ee | 


0 3 4 7 8 31 
Bits Contents 
0-3 The protection key for all commands associated with Start I/O. 


The protection key in the CAW is compared to a key in storage 
whenever a reference is nade to storage. 


4-7 This field is not used and must contain binary zeros. 
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8-31 The command address field contains the storage address (in 
hexadecimal representation) of the first CCW (channel command 
word) associated with the next or most recent Start I/O. 


CSW 


Use the CSW subcommand to display at the terminal the contents’ of the 
CSW (channel status word), as it existed at the time the debug 
environment was entered. The format of the CSW subcommand is: 


Usage Notes 


1. The CSW indicates the status of the channel or an input/output 
device, or the conditions under which an I/O operation terminated. 
The CSW is formed in the channel and stored in storage location 
X*40" when an I/O interruption occurs. If I/O interruptions are 
Suppressed, the CSW is stored when the next Start 1/0, Test I/O, or 
Halt I/O instruction is executed. 


2. Whenever antI/O operation abnormally terminates, issue the CSW 
Subcommand. The status and residual count information in the CSW 
is very useful in debugging. Also, use the CSW to calculate the 
address of the last executed CCW (subtract eight bytes from the 
command address to find the address of the last CCW executed). 


Responses 


The contents of the CSW are displayed at the terminal in hexadecinal 
representation. Its format is: 


ee ee ee ee ed pe TT eR ee Pe ee eee ae ea ee ee 
{|KEY]0000j Command Address | Status | Byte Count | 
ee CE | 


oO 34 78 31 32 47 48 63 


Bits Contents 

—3 The protection key is noved to the CSW from the CAW. It Shows 
the protection key at the time the I/O operation started. The 
contents of this field are not affected by programming errors 
detected by the channel or by the condition causing 
termination of the operation. 


4—7 This field is not used and must contain binary zeros. 

8—31 The command address contains a storage address (in hexadecinal 
representation) that is eight bytes greater than the address 
of the last CCW executed. 


32-47 The status bits indicate the conditions in the device or 
channel that caused the CSW to be stored. 
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48—63 The residual count is the difference between the number of 
bytes specified in the last executed CCW and the number of 
bytes that were actually transferred. When an input operation 
is terminated, the difference between the original count in 
the CCW and the residual count in the CSW is equal to the 
number of bytes transferred to storage; on an output 
operation, the difference is egual to the number of bytes 
transferred to the I/O device. 


DEFINE 


Use the DEFINE subcommand to assign a symbolic name toa_e specific 
storage address. Once a symbolic name iS assigned to a storage address, 
that symbolic name can be used to refer to that address in any of the 
other DEBUG subcommands. The format of the DEFINE subcommand is: 


ee ge Coe Oa gee ae Oe eg ED gag Me ee ee ee Be ge ee eS gee ae a 


c 1 

symbol hexloc | bytecount| 
| 4 l 
L 


| 
| DEFine 
| 
j J 


—_—_me~ 2 ee 


where: 

symbol is the name to be assigned to the storage address derived fron 
the second operand, hexloc. Symbol may be from one to eight 
characters long, and must contain at least one nonhexadecinal 
character. Any Symbolic name longer than eight characters is 
left-justified and truncated on the right after the eighth 
character. 

hexloc is the hexadecimal storage location, in relation to _ the 
current origin, to which the name specified in the first 
operand (symbol), is assigned. 

bytecount 


is a decimal number, between 1 and 56 incluSive, which 
specifies the length in bytes of the field whose name is 
specified by the first operand (symbol) and whose’ starting 
location is specified by the second operand (hexloc). When 
bytecount is not specified, 4 is assumed. 


Usage Notes 


1. Issuing the DEFINE subcommand creates an entry in the debug symbol 
table. The entry consists of the symbol name, the storage address, 
and the length of the field. A maximum of 16 symbols can be 
defined in the debug symbol table at any given time. 


2. When a DEFINE subcommand specifies a symbol that already exists in 
the debug symbol table, the storage address derived from _ the 
current request replaces the previous storage address. Several 
Symbols may be assigned to the same storage address, but each of 
these symbols constitutes one entry in the debug symbol table. The 
Symbols remain defined until they are redefined or until an IPL 
subcommand loads a new copy of CMS. 
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3. When you assign a symbolic name to a storage location, you nust 
know the current origin (set by the ORIGIN subcommand). The hexloc 
you specify is added to the current origin to create the entry in 
the symbol table used by DEBUG subcommands. If you change the 
current origin, existing entries are not changed. 


4. You can use symbolic names to refer to storage locations when you 
issue the DEBUG subcommands BREAK, DUMP, GO, ORIGIN, STORE, and X. 


Responses 


None. 


DUMP 


Use the DUMP subcommand to print part or all of your virtual storage on 
the printer. The requested information is printed offline as soon as 
the printer is available. First, a heading: 


ident FROM starting location TO ending location 


is printed. Next, the general registers 0-7 and 8-15, and the 
floating-point registers 0-6 are printed, followed by the PSW, CSW, and 
CAW. Then the specified portion of virtual storage is printed with the 
Storage address of the first byte inthe line printed at the left, 
followed by the alphameric interpretation of 32 bytes of storage. The 
format of the DUMP subcommand is: 


| l or r 1 #1 | 
| DUmr | | symbolt | symbol2 1 4 | 
| | | hexloct | hexloc2 [ident ] i | | 
l i | Q ; has oe | d 
i | ; 32 ae | l 
| | L L J Jj | 


symbol1 is the name assigned (via the DEFINE subcommand) to the 
storage address that begins the dump. 


hexloct is the hexadecimal storage location, in relation to current 
origin, that begins the dunp. 


symbol2 is the name assigned (via the DEFINE subcommand) to the 
storage address that ends the dump. 


hexloc2 is the hexadecimal storage location, in relation to the 
current origin, that ends the dump. 


* indicates that the dump ends at your virtual machine's last 
virtual storage address. 


ident is any name (up to eight Characters) that identifies the dump. 
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Usage Notes 


1. If you issue the DUMP subcommand with no operands, 32 bytes of 
storage are dumped, starting at the current origin. 


2. The first and second operands must designate storage addresses that 
do not exceed your virtual machine storage size. Also, the storage 
address derived from the second operand must be greater than the 
storage address derived from the first operand. 


Responses 


None. 


GO 


Use the GO subconmand to exit from the debug environment and begin 
program execution. The format of the GO subcommand is: 


De re a a ge ON eB an ee ge ee ee ee a ea ee Gee ee erg eee Ty ee 


7 
Symbol | 
hexloc | 
J 


GO 


==> 
—_ ee ee 


where; 

symbol is the symbolic name assigned to the storage location where 
you want execution to begin. 

hexloc is the hexadecimal location, in relation to the current 


Origin, where you want execution to begin. 


Usage Notes 


1. When you issue the GO subcommand, the general registers, CAW 
(channel address word), and CSW (channel status word) are restored 
either to their contents upon entering the debug environment, or, 
if they have been modified, to their nodified contents. Then the 
old PSW is loaded and becomes the current PSW. Execution begins at 
the instruction address contained in bits 40-63 of the PSW. 


2. When you specify symbol or hexloc with the GO subcommand, the 
specified address replaces the instruction address in the old PSW, 
so execution will begin at that address. If you entered the debug 


environment with the DEBUG command, you must specify an address 
with the GO subcommand. 


3. The address you specify must be within your virtual machine and it 
must contain a valid operation code. 


Responses 


Program execution is resumed. 
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GPR 


Use the GPR subcommand to display the contents of one or more general 
registers at the terminal. The format of the GPR subcommand is: 


| GPR | reg? [reg2]} | 


where; 

reg is a decimal number (from 0-15 inclusive) indicating the first 
or only general register whose contents are to be displayed. 

reg2 is a decimal number (from 0-15 inclusive) indicating the last 
general register whose contents are to be displayed. reg2 must 
be larger than reg1. 

Responses 


The register or registers specified are displayed, in hexadecimal 
representation: 


XXXXXXXX 


HX 


Use the HX subcommand to leave the debug environment, regardless of the 
reason the debug envircnment was entered. The format of ‘the HX 
subconmmand is: 


Responses 


If you entered the debug environment following a program interruption, 
you receive the message: 


CMS 


to indicate a return to the CMS environment. If you entered the debug 
environment by issuing the DEBUG command, you receive the message: 


DMSABN1I48T SYSTEM ABEND 2E4 CAILED FROM xxxxxx 


where xxxxxx is the address of the debug routine. 
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ORIGIN 
$ 


Use the ORIGIN subcommand to set an origin or base address to be used in 
the debug environment. The format of the ORIGIN subcommand is: 


Ge re ge ee reg eg eT pee ee ge Be ee ee ere ee 


| ORigin | (symbol [ 
| | | Bexoc | 
| l 0 I 
Oc a i a a i YS 


where: 

symbol is asymbolic name that was previously assigned (via the 
DEFINE subcommand) to a storage address. 

hexloc is a hexadecimal location within the limits of your virtual 


storage. If you do not explicitly set an origin, then it has 
a value of Q. 


- When the ORIGIN subcommand specifies a symbol, the debug symbol 
table is searched. If a match is found, the value corresponding to 
the symbol becomes the new origin. When a hexadecimal location is 
specified, that value becomes the origin. In either case, the 
operand cannot specify an address greater than your virtual storage 
size. 


2. Any origin set by an ORIGIN subcommand remains in effect uatil 
another ORIGIN subcommand is issued, or until you obtain a new copy 
of CMS. Whenever a new ORIGIN subcommand is issued, the value 
specified in that subcommand overlays the previous origin setting. 
If you obtain a new copy of CMS (via IPL), the origin is set to 0 
until a new ORIGIN subcommand is issued. 


3. You can use the ORIGIN subcommand to set the origin to your 
program's base address, andthen refer to actual instruction 
addresses in your program, rather than to virtual storage 
locations. 


Responses 


None. 
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PSW 


Use the PSW subcommand to display the contents of the PSW (progran 
status word). The format of the PSW subcommand is: 


Usage Notes 


1. If the debug environment was entered because of a progran 
interruption, the program old PSW is displayed. If the debug 
environment was entered because of an external interruption, the 
external old PSW is displayed. If the debug environment was 
entered for any other reason, the following is displayed in 
response to the PSW subcommand: 


01000000xxxxxxxx 


where the 1 in the first byte means that external interruptions are 
allowed and xxxxxxxx is the hexadecimal storage address of the 
debug progran. 


2. The PSW contains some information not contained in storage or 
registers but required for proper program execution. In general, 
the PSW is used to control instruction sequencing and to hold and 
indicate the status of the system in relation to the program 
currently executing. For a description of the PSW, refer to the 


VM/SP System Programmer's Guide. 


Responses 


The PSW is displayed in hexadecimal representation. 


RETURN 


Use the RETURN subcommand to exit from the debug environment and enter 
the CMS command environment. The format of the RETURN subcommand is: 


ee ey ee ae a ee ee ee ee ee ee 
j RETurn | ; 


eS es Ee eee SS eee ee ee) 


Usage Note 


The RETURN subcommand is valid only when the debug environment was 
entered via the DEBUG command. 


Responses 


The CMS ready message indicates that control has been returned to the 
CMS environment. 
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SET 


Use the SET subcommand to change the contents of the control words and 
general registers. The format of the SET subcommand is: 


| SET | (CAW hexinfo | 
| | )CSW hexinfo [hexinfo] | 
{ | )PSW hexinfo [hexinfo] | 
| | (GPR reg hexinfo [ hexinfo } [ 
where: 


CAW hexinfo 
stores the specified information (hexinfo) in the CAW (channel 
address word) that existed at the time the debug environment 
was entered. 


CSW hexinfo [hexinfo ] 
stores the specified information (hexinfo [hexinfo]) in the 
CSW (channel status word) that existed at the time the debug 
environment was entered. 


PSW hexinfo [ hexinfo] 
stores the specified information (hexinfo [hexinfo]) in the 
old PSW (program status word) for the interruption that caused 
the debug environment to be entered. 


GPR reg hexinfo [hexinfo] 
stores the specified information (hexinfo [hexinfo]) in the 
specified general register (reg). 


Usage Notes 

1. The SET subcommand can only change the contents of one control word 
at a time. For example, you must issue the SET subconmand three 
times: 

set caw hexinfo 
set csw hexinfo [hexinfo ] 
set psw hexinfo [hexinfo] 
to change the contents of the three control words. 

2. The SET subcommand can change the contents of one or two general 
registers each time it is issued. When four or fewer bytes of 
information are specified, only the contents of the specified 
register are Changed. When more than four bytes of information are 
specified, the contents of the specified register and the next 
sequential register are changed. For example, the SET subcommand: 

set gpr 2 xxxxxxxx 


changes only the contents of general register 2. But, the SET 
subcommand: 


set gpr 2 xxxxxxxx Xxxxxxxx 


changes the contents of general registers 2 and 3. 
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3. Each hexinfo operand should be from one to four bytes long. If an 
operand is less than four bytes and contains an uneven number of 


hexadecimal digits (representing half-byte information), the 
information is right-justified and the left half of the uneven byte 
is set to zero. If more than eight hexadecimal digits are 


specified in a single operand, the information is left-justified 
and truncated on the right after the eighth digit. 


4. The number of bytes that can be stored uSing the SET subcomnand 
varies depending on the form of the subcommand. With the CAW forn, 
up to four bytes of information may be stored. With the CSW, GPR, 
and PSW forms, up to eight bytes of information may be stored, but 
these bytes must be represented in two operands of four bytes each. 
When two operands. of information are specified, the information is 
stored in consecutive locations (or registers), even if one or both 
operands contain less than four bytes of information. 


Responses 


None. To display the contents of control words or registers after you 
modify them, you must use the CAW, CSW, PSW, and GPR subcommands. 


STORE 


Use the STORE subcommand to store up to 12 bytes of hexadecimal 
information in any valid virtual storage location. The format of the 
STORE subcommand is: 


BS A A a | 
{ STore | {symbol hexinfo [hexinfo jhexinfo] ] l 
i | ) hexloc 


where: 

symbol is the symbolic name asSigned (via the DEFINE subconmand) to 
the storage address where the first byte of specified 
information is to be stored. 

hexloc is the hexadecimal location, relative to the current origin, 


where the first byte of information is to be stored. 


hexinfo is the hexadecimal information, four bytes or less in length 
(that is, two to eight hexadecimal digits), to be stored. 


Usage Notes 


1. If an operand is less than four bytes long and contains an uneven 
number of hexadecimal digits (representing half-byte information), 
the information is right-justified and the left half of the uneven 
byte is set to zero. If more than eight hexadecimal digits are 
specified in a single operand, the information is ieft-justified 
and truncated on the right after the eighth digit. 


2. The STORE subcommand can store a maximum of 12 bytes at one time. 
By specifying all three information operands, each containing four 
bytes of information, the maximum 12 bytes can be stored. If less 
than four bytes are specified in any or all of the operands, the 
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information given is arranged into a string of consecutive bytes, 
and that string is stored starting at the location derived from the 
first operand. 


For example, if you have defined a four-byte symbol named FENCE 
that currently contains X'FFFFFFFF' and you enter: 


store fence 0 


FENCE contains X'OOFFFFFF'. 


Responses 


None. To display the contents of a storage location after you have 
modified it, you must use the X subcommand. 


X 


Use the xX subcommand to examine and display the contents of specific 
locations in virtual storage. The format of the X (examine) subconmand 
is: 


| l rc 1 | 
| X | [~symbol | o | | 
l l {| length | i 
\ | L oa | 
| | r 1 [ 
i i [hexloc ja | ] 
a | l 14 | l 
| | . 4 


Symbol n is the name assigned (via the DEFINE subcommand) to the 
storage address of the first byte to be displayed. an isa 
decimal number from 1 to 56 inclusive, that specifies the 
humber of bytes to be examined. If a symbol is specified 
without a second operand, the length attribute associated with 
that symbol in the debug symbol table specifies the number of 
bytes to be examined. 


hexloc n is the hexadecimal location, in relation to the current 
origin, of the first byte to be examined. If hexloc is 
specified without a second operand, four bytes are displayed. 


Usage Note 


The address represented by symbol or hexloc must be within your virtual 
machine storage size. 


Responses 


The requested information is displayed at the terminal in hexadecinal 
format. 
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Section 5. CMS EXEC Control Statements 


This section describes the formats, usage rules, and default values for 
CMS EXEC control words, including: 


e Control statements 
e Built-in functions 
@ Special variables 


An EXEC procedure is acCMS file that contains a sequence of CMS 
commands and/or EXEC control statements. Control statements determine 
the logic flow for EXEC, provide terminal communications, and may be 
used to manipulate CMS disk files. For an introduction to the EXEC 
facilities, and for complete tutorial information, including examples, 
consult the VM/SP CMS User's Guide. kefer to VMN/SP EXEC 2 Reference for 
information on EXEC 2. 


EXEC procedures may be invoked with the EXEC command, described in 
"Section 2. CMS Commands." You may also execute an EXEC procedure by 


specifying its filename, as long as the implied EXEC function is in 
effect. 
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The Assignment Statement 


Use the assignment statement in an EXEC procedure to assign a value to a 
variable symbol. Variable symbols may be tested and manipulated to 
control the execution of an EXEC procedure. The format of the 
assignment statement is: 


SSS SSS 
string 

Svariable = ae 
function 
X"*xxxxxx 

(a es nS PP ee RN SO PS | 


i= eee Se 


where: 


&Evariable indicates the variable symbol that is assigned the specified 
value. A variable may contain a Daximum of eight alphameric 
and national characters, including the initial ampersand, 
which is reguired. Except in the EXEC special variables &* 
and &DISK*, a variable must hot contain any special 
characters. 


string is a data item cf up to eight characters. It may also be a 
Variable symbol or anull. Whether a numeric string is 
treated aS numeric or character data depends on how it is 
used in the EXEC. If a string containing variable symbols 
expands to more than eight characters, it is truncated. If 
the string consists of eight X'FF' characters, the variable 
is set to a null string. 


ae is an arithmetic expression consisting of a sequence of data 
items that possess positive or negative integral values and 
are separated by plus or minus signs: 
&1—- 4 + &CALC —- 6 


function is an EXEC built-in function followed by at least one token. 


X"xxxXxxx indicates up to six hexadecimal digits to be converted to 
decimal before assignment. For example: 


G&A = X'*CO0 
results in &A having the decimal value 192. 


Hexadecimal conversion is not performed unless you have used 
the &HEX ON control statement. 


Variable Substitution 


All variable symbols occurring in executable statements are substituted 
before the statement is executed. An executable Statement is (1) a CMS 
command line, or (2) an EXEC control statement (including assignment 
statements). 
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Variable substitution is performed on all symbols on the left-hand 
side of an assignment statement, except the leftmost variable. For 
example: 


&I = 2 
&X6I = 5 
sets &X2 to 5. 


If a variable on the left-hand side of an assignment statement has 
already been assigned a value, it is replaced by the new value specified 
in the assignment statement. 


If the special form, xX'&symbol, is used, the specified symbol is 
converted to its hexadecimal equivalent. For example: 


SA = 192 
STYPE X'&A 


results in the display: 
co 


if avariable symbol that has not been defined is used in an 
executable statement the symbol is set to a null token and ignored. In 
some instances this may cause an EXEC processing error. 


Tokens 


All executable statements in an EXEC are scanned into eight-character 
tokens, and padded or truncated as necessary. Tokens are formed of words 
delimited by blanks and fparentheses. If there is no blank before or 
after a parenthesis, one is added in either case. If more than one 
blank separates a word or a parenthesis from another, the extra blanks 
are removed from the line. For example, the line: 


&TYPE THIS IS AN EXAGGERATED (MESSAGE 
scans as: 
S6TYPE THIS IS AN EXAGGERA ( MESSAGE 


Variable symbols are substituted after each line is scanned, and each 
token is scanned repeatedly until all symbols in it are substituted. 


In an executable statement, a token beginning with the character 
X*FF* (or a variable to which such a token is assigned as a value) 
usually prevents the processing of data following it on the same line. 
However, if an asSignment statement sets a variable to eight X*FF'* 
Characters, data following the variable in an executable statement is 
fFrocessed. 
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& ARGS 


Use the &SARGS control statement to redefine the value of one or more of 
the special variables, &1 through &30. The format of the &ARGS control 
statement is: 


Se SS SSS eS ee 
{| &ARGS | [argl1 [arg2 ... [arg30] ] ] | 
——E———————————————e—_—_——————_—E—EeE—Eee eee eee a eed 


where: 


{[arg1 [arg2 ... [arg30]]] 
specify up to 30 tokens to be assigned to the special 
variables &1 through &30. If no arguments are specified, all 
of the variables &1 through &30 are set to blanks. When fewer 
than 30 arguments are entered, the remaining arguments are set 
to blanks. An argument is also set to blanks if it is 
Specified as a fercent sign (%). 


Usage Notes 
1. To enter an argument list from the terminal, use the 6&READ ARGS 
control statement. 


2. An S&ARGS control statement resets the values of the &SINDEX, &*, and 
&$ special variables. 


& BEGEMSG 


Use the &BEGEMSG control statement to introduce one or more unscanned 
lines to be edited as VM/SP error messages. The list of lines’ to be 
displayed must be terminated by an 6&END control statement, which must 
appear beginning in column 1. The format of the &BEGEMSG control 
statement is: 


en a ee ee ee ee a eee Renee 
| SBEGEMSG | [ALL] | 
SS ee eee — eee eee ee ee eee 


ALL specifies, for fixed-length EXEC files, that the entire line 
(to a maximum of 130 characters) is to be displayed. 
Usage Notes 
1. To qualify for error message editing, the first data item on each 
line following the &BEGEMSG control statement must be _ seven 


Characters long, in the format: 


hoaaAnnaNnS 


426 IBM VM/SP CMS Command and Macro Reference 


EXEC Control Statements-&BEGEMSG 


fmmnnn is a six-character message identification you can supply 
for the error message. Standard VM/SP error messages use a 
three-character module code (Mmm) andaée three-character 
message number (nnn). 


s indicates the severity code. The following codes qualify 
the message for error message editing: 


Code Message Type 


I Informational 
E EFLIOL 
W Warning 


When the severity code is E, I, or W, the message is 
displayed in accordance with the CP EMSG setting (ON, OFF, 
CODE, or TEXI). You can change this setting with the CP 
SET command, described in VM/SP CP Command Reference for 
General Users. 


When you use the &BEGEMSG control statement to display error 
messages, the character string "DMS" is inserted in front of the 
seven-cCharacter message identification. For example, if the EMSG 
setting is ON, the lines: 


& BEGEMSG 
TESTO1E INSURMOUNTABLE ERROR 
& END 


result in the display: 
DMSTESTO1E INSURMOUNTABLE ERROR 


Note: Since the maximum length of a line that you can display at 
your terminal is 130 characters, the insertion of the characters 
DMS will cause lines greater than 127 characters long to be 
truncated. 


Messages that are displayed as the result of an &BEGEMSG control 
statement are not scanned by the EXEC interpreter. Therefore, no 
variable substituticn is performed and no data items are truncated. 
To display variable data, use the &EMSG control statement. 
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& BEGPUNCH 


Use the &BEGPUNCH control statement to delimit the beginning of a list 
of one or nore data lines to be spooled to your virtual card punch. The 
list of lines to be punched is terminated by the control statement &END, 
which must occur beginning in column 1. The format of the &BEGPUNCH 
control statement is; 


Co ee a ee Se ee ge ee ee ee ee ee ae 
| S&BEGPUNCH | [ALL] | 
SSS ee ee es | 


where: 


ALL specifies that data occupying columns 73 through 80 should he 
punched. If ALL is not specified, input records are truncated 
at column 72 and columns 73 through 80 of the output record 
are padded with blanks. 


Usage Notes 


1. Lines that are punched as the result of an &BEGPUNCH control 
statement are not scanned by the EXEC interpreter. Therefore, no 
variable substitution is performed and no data items are truncated. 
To punch variable data, you must use the &PUNCH control statement. 


2. When you are finished punching lines in an EXEC procedure, you 
should use the CP CLOSE command to close your virtual punch. 


& BEGSTACK 


Use the &BEGSTACK control statement to delimit the beginning of a list 
of one or more data lines to be placed in the console stack. The list 
of lines to be stacked is terminated by the control statement SEND which 
must occur beginning in column 1. The format of the &BEGSTACK control 
statement is: 


where: 

FIFO Specifies that the lines that follow are to be stacked ona 
first in, first out basis. This is the default value. 

LIFO specifies that the lines that follow are to be stacked ona 
last in, first out basis. 

ALL specifies, for fixed-length EXEC files, that the entire line 


(to a maxinum of 130 characters) is to be stacked. If ALL is 
not specified, the lines are truncated in column 72. 
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Usage Notes 


1. Lines that are stacked as the result of an &BEGSTACK control 
Statement are not scanned by the EXEC interpreter. Therefore, no 
variable substitution is performed, and data items are not 
truncated. To stack variable data, you must use the &STACK control 
statement. 


2. To stack a null line in an EXEC file you must use the &STACK 
control statement. A null line following an &BEGSTACK control 
statement is interpreted as a line of blanks. To stack an INPUT, 
REPLACE, or CHANGE subcommand to eater input mode from a 
fixed-length EXEC, you should use the &STACK control statement. 


& BEGTYPE 


Use the &BEGTYPE control statement to delimit the beginning of a list of 
ohe or more data lines to be displayed at the terminal. The list of 
lines to be displayed is terminated by the control statement SEND, which 
must occur beginning in column 1. The format of the &BEGTYPE control 
statement is: 


ce ee ee ee ae gg ee pte ae eg he a ee ae ye —— ee 
| S§&BEGTYPE | [ALL] | 


where: 

ALL specifies, for fixed-length EXEC files, that data occupying 
columns 73 through 130 1s to be displayed. If ALL is not 
specified, the lines are truncated at column 72. 

Usage Note 


Lines that are displayed as the result of an &BEGTYPE control statement 
are not scanned by the EXEC interpreter. Therefore, no variable 
substitution is performed, and data items are not truncated. To display 
Variable data, you must use the &TYPE control statement. 
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& CONTINUE 


Use the &CONTINUE control statement to instruct the EXEC interpreter to 
process the next statement in the EXEC file. The format of the 
ECONTINUE control statement is: 


es ee ee ea ae ee Pa Ee ae a as eg eT ee ee gS are Ee eS Oe ees 
| SCONTINUE | 
(aaa ee a ee | 


Usage Note 


&CONTINUE is generally used with an EXEC label (for example, -LAB 
SCONTINUE) to provide a tEranch address for &SERROR, &GOTO, and other 
branching statements. &CONTINUE is the default action taken when an 
error is detected in processing a CMS command. 


& CONTROL 


Use the &CONTROL control statement to specify the amount of data to be 
displayed in the execution summary of an EXEC. The format of the 
SCONTROL control statement is: 


ci vivian hk  eeaeee_=_=S___ _—__ 
| l or 1 of 1 °=#«OF6F 1 ~«OC 1 | 
| &CONTROL | {OFF | {SSG | {TIME | JPACK | l 
| l |} ERROR] | NOMSG] {| NOTIME | {| NOPACK | | 
| 1 {cms 4 & 4s ot 5 ot 4 i 
[ {  |ALL | A 
l i ¢ 4 | 


where: 

OFF Suppresses the display of CMS commands and EXEC’ control 
statements as they execute and of any return codes that may 
result from CMS commands. 

ERROR displays only those CMS commands that result in an error and 
also displays: the error message and the return code. 

CMS displays each CMS command as it is executed and all nonzero 
return codes. 

ALL displays CMS commands and EXEC executable statements as they 
execute as well as any nonzero return codes from CMS commands. 

MSG does not suppress the "FILE NOT FOUND" message if it is issued 
by the following commands when they are invoked from an EXEC 
procedure: ERASE, LISTFILE, RENAME, or STATE. 

NOMSG Suppresses the "FILE NOT FOUND" message if it is issued when 


the ERASE, LISTFILE, RENAME, or STATE commands are invoked 
from an EXEC frocedure. 
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includes the time-of-day value with each CMS command printed 
in the execution summary; for example; 

14:36:30 TYPE A B 


This operand is effective only if CMS or ALL is also 
specified. 


ME does not include the time-of-day value with CMS commands 


printed in the execution summary. 


PACK packs the lines of the execution summary so that’ surplus 
blanks are removed from the displayed lines. 
NOPACK does not pack the lines of the execution summary. 


Usage Notes 


‘hs 


The execution summary may consist of CMS commands, responses, error 
messages, and return codes, as well as EXEC control statements and 
assignment statements. When EXEC statements are displayed, they 
are displayed in their scanned format, with all variable symbols 
substituted. 


Each operand remains set until explicitly reset by another &SCONTROL 
statement that specifies a conflicting operand. When &CONTROL is 
used with no operands, all operands are reset to their default 
values. 


There is no global setting for & CONTROL. When an EXEC is nested 
within another EXEC, the execution summary is controlled by the 
nested EXEC's &CONTROL setting. When control returns to the outer 
EXEC, the original &CCNTROL setting is restored. 


& EMSG 


Use the &EMSG control statement to display a line of tokens to be edited 
as a VM/SP error message. The format of the &EMSG control statement is: 


EEE | 
{ SEMSG | mmmnonns [tok1 ... [tokn]] | 


De nent ee eee Set carers on ii pee ag i ig all 


where; 

nmmnnan is a six-character identification you may supply for the error 
message. Standard VM/SP messages are coded using a 
three-character module code (mma) and a three-character 
message humber (nnn). 

s indicates the severity code. The following codes qualify the 


message for error message editing: 


Code Message Type 
Information 
Error 
Warning 
Response 


er 
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tok1 ...[tokn ] 
is the text of the message to be displayed. 


1. When the severity code is I, E, or W, the message is displayed in 
accordance with the CP EMSG setting (ON, OFF, CODE, or TEXT). You 
can Change the setting with the CP SET command, described in VM/SP 
CP Command Reference for General Users. 


2. When an &EMSG code is displayed, it is prefixed with DMS. For 
example, the statement: 


&EMSG ERROR1IE INVALID ARGUMENT 
displays as follows when the EMSG setting is ON: 
DMSERROR1TE INVALID ARGUMENT 
3. To display an error message with unsubstituted data, or to display 


a line with words of more than eight characters, use the &BEGEMSG 
control statement. 


& END 


Use the &END control statement to terminate a list of one or nore lines 
that began with an &BEGEMSG, &BEGPUNCH, &BEGSTACK, or &BEGTYPE control 
Statement. The format of the &END control statement is: 


| &END | l 


The word "&END" must be entered beginning in column 1. 


& ERROR 


Use the &ERROR control statement to specify the action to be taken when 
a CMS command results in anerror and returns with a nonzero return 
code. The format of the &ERROR control statement is: 


a ee ee ee ae Oe Ore eee SO et En ge a mC ee MSG Pe eT ore OO Rae eee ge Ne eae, ge ee Te eT ene 


|& CONTINUE { 


Ll J 
a A a ee a | 


l oof 7 
&S&ERROR | jexecutable—statenent | 

i 

l 


mae Ee ee 
meee Eee 


where: 


executable-statement 
specifies any executable statement, which may be an EXEC 
control statement or asSignment statement or a CMS command. 
If you specify an EXEC control statement that transfers 


432 IBM VM/SP CMS Command and Macro Reference 


EXEC Control StatementS-SERROR, &EXIT 


control to another line in the EXEC, execution continues at 
the specified line. Otherwise, execution continues with the 
line following the CMS command line that caused the error. 


Usage Notes 


1. If your EXEC does not contain an &ERROR control statement, then the 
default is SCONTINUE; that is, EXEC processing is to continue with 
the line following the CMS command that caused the error. You can 
use GSERROR &CONTINUE to reset a previous GSERROR statement. : 


2. The words following an E& ERROR control statement are not scanned 
until a CMS command returns a nonzero return code. Therefore, if 
you specify an invalid EXEC statement, the error is not detected 
until a CMS command failure triggers the &ERROR statement. If the 
&ERROR statement executes a CMS command that also results in an 
error, EXEC processing is terminated. 


& EXIT 


Use the €EXIT control statement to terminate processing the EXEC file. 
If the exit is taken from a first-level EXEC procedure, control passes 
to CMS. If the exit is taken froma nested EXEC procedure, control 
passes to the calling EXEC procedure. The format of the &EXIT control 
statement is: 


0 | 


| {i 7 
| &EXIT | #£=|return—code| 
4 i si 

[ot 4 


return-code 
specifies a numeric value, which may be a variable symbol, to 
be used as the return code from this EXEC. If the return code 
is not specified, it defaults to 0. 

Usage Notes 


1. If control is returned to CMS, the CMS ready message indicates the 
return code value. Thus, the statement: 


S&EXIT 12 
results in the ready message: 
R (00012) ;T=0/702 15:32:34 
2. If you specify: 
&EXIT &SRETCODE 


the return code value displayed is the return code from the most 
recently executed CMS command. 
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& GOTO 


Use the &GOTO control statement to transfer control toa specific 
location in the EXEC procedure. Execution then continues at the 
location that is branched to. The format of the &GOTO control statement 
is: 


| &GOTO | TOP | 
| | line—number | 
—label 


% 


TOP transfers control to the first line of the EXEC file. 
line- number transfers control to a specific line in the EXEC file. 


-label transfers control to a specific label in the EXEC file. A 
label must begin with dash (-), and it must be the first 
token on a line. The remainder of the line may contain an 
executable statement or it may be null. 


Usage Notes 


1. Scanning for an EXEC label starts on the line following the &GOTO 
statement, goes to the end of the file, then to the top of the 
file, and {if unsuccessful) ends on the line above the &GOTO 
statement. If more than one statement in the file has’ the sane 
label, the first one encountered by these rules satisfies the 
search. 


2. To provide a branch up or down a specific number of lines in the 
EXEC, use the &SKIP control statenent. 


& HEX 


Use the &HEX control statement to initiate or inhibit hexadecinal 
conversion in an EXEC procedure. The format of the &HEX control 
statement is: 


where: 

ON indicates that tokens beginning with the string X' are to be 
interpreted as hexadecimal notation. 

OFF indicates that no hexadecimal conversion is to be done by 


EXEC. OFF is the default setting. 
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Usage Notes 


1. You should use the &HEX control statement when you want to display 
a hexadecimal value. For example: 


&SHEX ON 
STYPE X*40 
SHEX 


results in the display: 
28 


If you did not use the &SHEX ON control statement, the &TYPE 
statement would result in the display: 


X'40 


2. To convert a hexadecimal value to its decimal equivalent, use an 
asSignment statement. 


3. The VM/SP CMS User's Guide should be consulted for details and 
examples of correct usage of EXEC control statements with &HEX ON 
in effect. 


& IF 


Use the &IF control statement to test a condition in an EXEC procedure 
and to perform a particular action if the test is valid. If the test is 
invalid, execution continues with the statement following the é&IF 
control statement. The format cf the SIF statement is: 


&$ 


Dr ee eg ee ag eg epee ee fee ng ae eee te ee Cm ee ee ee et ee eee 
| &IF | tokent operator token2 executable—statenment { 
§* 


where: 

token1 May be numeric constants, character strings, or EXEC variable 

token2 symbols. All variable symbols are substituted before the &IF 
statement is executed. 

&$ tests all of the arguments entered when the EXEC was invoked. 
If at least one of the arguments satisfies the specified 
condition, the SIF statement is true. 

&* tests all of the arguments entered when the EXEC was invoked. 


All of the entered arguments must meet the specified condition 
in order for the SIF statement to be true. 


operator indicates the test to be performed on the tokens. If both 


tokens are Dhumeric, an arithmetic test is performed. 
Otherwise, a logical (alphabetic) test is performed. The 
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comparison operators, listed below, may be specified either in 
Symbolic or mnemonic focn: 


Symbol Operation 
= or EQ eguals 
== or NE not equal 
< or LT less than 
<= or LE less than or equal to (not greater than) 
> or GI greater than 
>= or GE greater than or equal to (not less than) 


executable-statement 
is any valid EXEC executable statement which may bea CMS 
command, an EXEC control Statement, or an assignment 
Statement. You may also specify another &IF statement; the 
number of nested SIF statements allowed according to _ the 
following criteria: 


CMS EXEC file: a maximum of 32 tokens is allowed for a 
variable length file. 


EXEC 2 file: the record length of the file. 


Usage Notes 


1. The values &* and &$ are reset when an &SARGS or &READ ARGS control 
Statement is executed. They are not changed when you reset a 
specific numeric variable (&1 through &30). 


2. If a variable symbol used in an &IF control statement is undefined, 
the EXEC interpreter cannct properly compare it. In cases where a 
variable may be null, or to check for a null symbol, you should use 
a concatenation character when you write the &IF statement; for 
example; 


SIF .&1 EQ . &GOTO -NOARGS 
tests for a null symrol &1. 


3. If the symbols &* or &$ are null because no arguments were entered, 
the entire &iIF statement is treated as a null statement. 


& LOOP 


Use the &LOOP control statement to describe a loop in an EXEC procedure, 
including the conditions for exit from the loop. The format of the 
&LOOP control statement is: 


Free poe ye ee ee ee Be ee oe ee ee GE ee Gee ee ee ee ee a a ee aL ae ee 


| &LOOP | n } 2 l 
| | —label condition l 


n is a positive integer from 0 to 4095 that indicates’ the 
number of executable and nonexecutable lines in the loop. 
These lines nust immediately follow the &LOOP statenent. 


436 IBM VM/SP CMS Command and Macro Reference 


EXEC Control Statements-&LOOP, &PUNCH 


-~label specifies that all of the lines following the &LOOP 
statement down to, and including the line with the specified 
label, are to be executed in the loop. The first character 
of the label must be a hyphen, and it must be the first 
token on a line. The remainder of the line may contain an 
executable statement, or it may be null. 


n is a positive integer from 0 to 4095 that indicates’ the 
number of tines the loop is to be executed. 


condition specifies the condition that must be met. The syntax of the 


exit condition is the same as that inthe 6&IF statement, 
that is: 


tok1) operator {tok2 
&S &S 
& * &* 


1. When loop execution is complete, control passes to the next 
Statement following the end of the loop. 


Usage Notes 


2. The condition is always tested before the loop is executed. If the 
specified condition is met, then the loop is not executed. For 
example, the statement: 


&LOOP 3 &CCUNT = 100 


specifies that the next three lines are interpreted until the value 
of &COUNT is 100. 


3. Loops may be nested up to four levels deep. All nested loops nay 
end at the sane label. 


4. A loop is closed when the requirements for termination specified in 


the &LOOP statement are met, or when control is transferred outside 
the scope of the loop (via &GOTO or &SKIP). 


& PUNCH 


Use the &PUNCH control statement to punch a line of tokens to the 
virtual card punch. The format of the &PUNCH control statement is: 


DR re ee ee ee Re en SS ee ee ee 
{| &PUNCH | [tok1 [tok2 ... [tokn]]] | 
a 
where: 


tok? [tok2 ... [tokn]] 
specifies the tokens to be punched. All tokens are padded or 
truncated to eight characters. The punched line is right-padded 
with blanks to fill an 80-column card. If no tokens are specified, 
a line consisting of 80 blank characters is punched. 
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Usage Notes 


1. Lines punched with the &PUNCH control statement are scanned by the 
EXEC interpreter and variable symbols are substituted before the 
line is punched. In fixed-length EXEC files, only the first 72 
characters of the record are scanned. T0O punch one or nore lines 
of unscanned data, use the &BEGPUNCH or &BEGPUNCH ALL control 
statement. 


2. When you have finished punching lines in an EXEC procedure, you can 
use the CP command CLOSE to close the spool punch file and release 
it for processing. 


& READ 


Use the &READ control statement to read one or more lines from the 
console stack. The lines may contain data or executable statements. 
The format of the &READ control statement is: 


< 
4 
d 
l 
RS [&var1 [&var2 ... [&varn]]]] 
Jd 


n reads the next n lines from the terminal and. treats them as if 
they had been in the EXFC file. Reading from the terminal 
stops when n lines have been read, or when an &LOOP statement 
Or a statement that transfers control is encountered. If an 
SREAD statement is encountered, the number of lines to be read 
by it is added to the number outstanding. 


(» 


If n is not specified, the default 1 is assumed, and the EXEC 
continues processing after reading a single line. 


ARGS reads a Single line, assigns the entered tokens to the special 
variables &1, 6&2, «..-, &n, and resets the special variables 
SINDEX, &*, and &$. 


If any of the tokens is specified as a percent sign (%) or 
begins with the character X'FF', the corresponding argument is 
set to blanks. 


VARS [&varl [&var2 ... [&varn]]] 
reads a single line and assigns the tokens entered to the 
Variable symbols &varl, &var2, ~-., &varn (up to 17). 


These variables are scanned in the same way as'~ though they 
appeared on the left-hand side of an asSignment statement. If 
no variable names are specified, any data read from the 
terminal is lost. 


If any of the tokens is specified as a percent sign (%) or 


begins with the character X'FF', the corresponding variable is 
set to blanks. 
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Usage Note 


You can test the special variable &READFLAG to determine whether the 
next &READ statement will result ina physical read to your terminal 
(the value of SREADFLAG is CONSOLE) or in reading a line from _ the 
console stack (the value of &SREAITFLAG is STACK). 


& SKIP 


Use the &SKIP control statement to cause a specified number of lines in 
the EXEC file to be skipped. The format of the &SKIP control statement 
is: 


Im 
le ome = ol 
—— @= Ge oe 


where: 
n specifies the number of lines to be skipped: 


e If nis greater than 0, the specified number of lines are 
Skipped. Execution continues on the line following the skipped 
lines. If the value of no surpasses the number of lines 
remaining in the file, the EXEC terminates processing. 


°e If n is equal tc 0, no lines are skipped, and execution 
continues with the next line. 


e If n is less than 0, execution continues with the line that is a 
lines above the current line. An attempt to skip beyond the 
beginning of the file results in an error exit from the EXEC. 


e The n may be coded as a variable symbol. 1 is the default value 
that is used when no value is specified for nan. 
Usage Note 
To pass control to a particular label in an EXEC procedure, use the 
&GOTO control statement. The &GOTO control statement provides nore 


flexibility when you want to update your EXEC procedures. The &SKIP 
statenent, however, is more efficient, in terms of execution time. 
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& SPACE 


Use the &SPACE control statement to display a specified number of blank 
lines at your terminal. The format of the &SPACE control statement is: 


Ge ge te ape ey FF ee EE et fe ag ne EB gag EY GRO GE Te ee OC Tea Ae a eee ag 
ESPACE 


a oe ee oe 

| li 
im 

bes eee oe ed 


| 
| 
l 
| 


specifies the number of blank lines to be displayed at the 
terminal. If no number is specified, &SPACE 1 is assumed by 
default. 


=) 


Usage Notes 


1. You may want to use the &SPACE control statement to control the 
format of the execution Summary that displays while your’ EXEC 
executes. 


& STACK 


Use the &STACK control statement to stack a single data line in the 
console stack. Stacked lines may be read hy the EXEC, by CMS, or by the 
CMS editor. The format of the &STACK control statement is: 


l il or tr _ 
{1 &STACK | |FIFO] | tok1 [tok2 ... [tokn Jj]jj f 
[ { |LIFO| | AT ; l 
[ ; & 4+ | RT l i 
l l : = | 


where: 

FIFO specifies that the line is to be stacked ina first in, first 
out sequence. FIFO is the default. 

LIFO specifies that the line is to be stacked in a last in, first 


out sequence. 


tok1 [tok2 ... jtokn]] 
specify the tokens to be stacked. If no tokens are specified, 
a null line is stacked. The tokens are in expanded forn. 


HT stacks the CMS Immediate command HT (halt typing), which is 
executed immediately. All CMS terminal display from the EXEC, 
except for CMS error messages with a suffix letter of ‘'S*' or 
'T*, is suppressed until the end of the file or until an RT 
(resume typing) command is read. 
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RT stacks the CMS Immediate command RT (resume typing), which is 
executed immediately. If CMS terminal display has been 
suppressed as the result of an HT (halt typing) request, 
display is resumed. 


1. Lines stacked with the &STACK control statement are scanned by the 
EXEC interpreter and variable symbois are substituted before the 
line is stacked. Te stack one or more unscanned lines, use the 
EBEGSTACK or &BEGSTACK ALL control statement. 


2. You must use the &STACK control statement when you want to stack a 
null line. 


3. The commands SET CMSTYPE HT and SET CMSTYPE RT perform the same 
functions as &STACK HI and &STACK RT. 


4%. A complete discussion of techniques you can use to stack commands 
and data in the console stack is provided in the VM/SP CMS User's 
Guide. 


& TIME 


Use the &TIME control statement to request timing information to be 
displayed at the terminal after each CMS command that is executed. The 
format of the &TIME contral statement is: 


bes ee ess ee oe 


where; 

ON resets the processor's time before every CMS command, and 
prints the timing information on return. If the &CONTROL 
control statement is set to CMS or ALL, the display of the 
timing information is followed by a blank line. 

OFF does not automatically reset the processor's time before every 
CMS command, nor does it print the timing information on 
return. 

RESET performs an immediate reset of the frocessor's time. 

TYPE displays the current timing information (and resets’ the 


processor's time). 


Usage Notes 
1. When timing information is displayed, it is in the fornat: 


T=x.xx/y-yy hh:mm:ss 
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where; 

X. XX is the virtual frocessor's time used since it was last 
reset in the current EXEC file. 

y-yy is the total of the processor's time used since it was 


last reset in the current EXEC file. 
hh:mm:ss is the actual time of day in hours: minutes:seconds. 
2. The processor's time is set to zero before the execution of the 


first statement in the EXEC file, and is again set to zero (reset) 
whenever timing information is printed. 


& TYPE 


Use the &TYPE control statement to display a line of tokens at’ the 
terminal. The format of the &TYPE control statement is: 


ee ng OF ee Ey Te NE Ce gh PN ye Ey a ET ee Oe EE ee EEG NT Ra ee ay SE Tn, ae ee ee 
| S&TYPE | [tok1 [tok2 ... [tokn]]] l 
_ Se es SS Ae ae EE a 
where: 


tok1 [tok2... [tokn]] 
specify the tokens to be displayed. All tokens are padded or 
truncated to eight characters. If no tokens are specified, a 
null line is displayed. 


Usage Note 
Lines displayed with the &TYPE control statement are scanned by the EXEC 
interpreter and variable symbols are substituted before the line is 


Gisplayed. To display one cr more unscanned lines, use the &BEGTYPE or 
SBEGTYPE ALL control statements. 
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Built-in Functions 


You can use the EXEC built-in functions to assign and manipulate 
variable symbols. With the exception of &LITERAL, built-in functions 
may be used only on the right-hand side of an assignment statement, as 
follows: 

&MIX = &CONCAT &1 6&2 
Built-in functions may not ke combined with arithmetic expressions. 


Each of the built-in functions (&CONCAT, S&DATATYPE, O&LENGTH, 
GSLITERAL, and &SUBSTR) is described separately. 


& CONCAT 


Use the &CONCAT function to concatenate two or more tokens and assign 
the result to a variable symbol. The format of the &CONCAT function is: 


eee nl kk ll ny 
| &variable = &CONCAT tok1 [tok2 ... [tokn]] l 
_—— a a a ee ee ea ae eee RT a ae Rae ea 0 OE eR Ee eT | 


where: 


Evariable is the variable symbol whose value is determined by the 
GSCONCAT function. 


tok1 [tok2...[tokn ]] 
Specifies the tokens that are to be concatenated into a 
Single tcken; for example: 


SA = ** 


&B &CONCAT XX GA 45 
&TYPE &B 


results in the printed line: 


XX*¥*45 
Usage Note 


If the concatenated token is longer than eight characters, the data is 
left-justified and truncated on the right. 
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& DATATYPE 


Use the &DATATYPE function to determine whether the value of the 
specified token is alphaketic or numeric data. The format of the 
EDATATYPE function is: 


le a a a ee pe ge ge ge gps Wee gg eT SON ee RE Oe ee ee SO OG eae ee a ee ee eae 
| &variable = &DATATYPE token j 
ee ey 


where: 


&variable is the variable symbol whose value is determined by the 
&DATATYPE function. 


token Specifies the target token that is to be examined for 
alphabetic or numeric data. The result of the &DATATYPE 


function has the value NUM or CHAR, depending on the data 
type of the specified token. For example: 


&ECHECK = &DATATYPE ABC 
&TYPE &CHECK 


results in the display: 
CHAR 


A null token is considered character data. 


& LENGTH 


Use the &LENGTH function to determine the number of characters ina 
token. The format of the &LENGTH function is: 


SS ee ee 
| &S&variable = &LENGTH token | 
rrr crm irri nee reir marine rs mm rs siemens cers ri ics us ii tii i cscs er mers ia inet eniotcel 


where: 


Svariable is the variable symbol whose value is determined by the 
&LENGTH function. 


token specifies the target token that is to be examined for 
nonblank characters. The result of the &LENGTH function is 
the number of nonblank characters in the specified token. 
For example: 


S&LEN = &LENGTH ALPHA 
STYPE &LEN 


results in the display: 


5 
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& LITERAL 


Use the 6&LITERAL function to inhikit variable substitution on the 
specified token. The &LITERAL function may appear in any EXEC control 
Statement, as follows: 


-—— 
[ L ome ] SLITERAL token[ ane ] | 
es A IANS IA Ie SIG Se nT ee 


where: 
token specifies the token whose literal value is to be used without 
substitution. For example: 
&X = ** 
GSTYPE E&LITERAL &X EQUALS &X 
results in the printed line: 
&X EQUALS ** 
& SUBSTR 


Use the &SUBSTR function to extract a character string from a specified 
token and to assign the substring to a variable symbol. The format of 
the &SUBSTR function is: 


a ae 
| Svariable = &SUBSTR token i [j] i 
A i ee ee eee 


where; 


&variable is the variable symbol whose value is determined by the 
&SUBSTR function. 


token is the token from which the character string is to be 
extracted. 
a specifies the character position in the token of the first 


character to be used in the substring. 


5 specifies the number of characters in the string. If 
Omitted, the remainder of the token is used. 


Usage Note 


The values of i andj (if given) must’ be positive integers. For 
example: 


6A = &SUBSTR ABCDE 2 3 
ETYPE &A 


results in the printed line: 


BCD 
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Special variables are variable symbols that are assigned values by the 
EXEC interpreter, and that you can test or display in your EXEC 
procedures. In some cases, you may asSign your own values to EXEC 
special variables; these cases are noted in the variable descriptions. 


&n 


The &n special variable represents the numeric variables &1 through &30. 
When an EXEC is invoked, the numeric variables from &1 through &30 are 
initialized according to the arguments that are passed to the EXEC file 
(if any). 


The numeric variables can be reset by either an &S&ARGS or &READ ARGS 
control statement; when fewer than 30 arguments are set or reset, the 
remainder of the &n variables are set to blanks. A particular argument 
can be set to blanks by assigning it a percent Sign (%) when invoking 
the EXEC procedure, in an &ARGS control statement, or in an &READ ARGS 
control statement. An argument is also set to blanks if it begins with 
the character X'FF* and is' specified when invoking the EXEC procedure or 
in an &READ ARGS control statement. 


You may set the values of specific argumentS uSing assignment 
statements. Any value of n, however, that is greater than 30 or less 
than 0 is rejected by the EXEC interpreter. 


&* and &$ 


These variables can be used to perform a collective test on all of the 
arguments passed to the EXEC procedure. 6&* and &$ may only be used in 
the SIF and &LOOP control statements and are described under the 
description of the &IF control statement. You may not assign values to 
the special variables &* and &$. 


& 0 


The &0 special variable contains the filename of the EXEC file. You may 
test and manipulate this variable. 


& DISKx 


You can use the &DISKx special variakle to determine whether a disk is 
an OS, DOS, or CMS disk. x represents the mode letter at which the disk 
is accessed. For example, if you access an OS disk with a mode letter 
of C, then the special variable &DISKC has a value of OS. The possible 
values for the &DISKx special variable are OS (for an OS disk), DOS (for 
a DOS disk), CMS (for a CMS disk), and NA (when the disk is. not 
accessed). 


You may set or change the values of an &DISKx special variable. If you 
do so, you are no longer able to test the status of the disk at node x. 
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& DISK* 


The &DISK* special variable contains the one-character mode letter of 
the first read/write disk in the CMS search order. If you have ano 
read/write disks accessed, this special variable contains the value 
NONE. 


You may assign a value to the &DISK* special variable for your own 
use; if you do so, however, you will not be able to use it to obtain the 
filemode letter of a read/write disk. 


& DISK? 


You can use the &DISK? special variable in an EXEC to determine which 
read/write disk that you have accessed has the most space on it. If you 
have no read/write disks accessed or if the accessed disk is full, 
EDISK? contains the value NONE. 


You may assign a value to the &DISK? special variable for your own 


use; if you do so, however, you will no longer be able to locate the 
read/write disk with the most space. 


& DOS 


The &DOS special variable contains one of the two character values ON or 
OFF, depending on whether the CMS/DOS environment is active. If you 
have issued the command: 
set dos on 
then the &DOS special variable contains the value ON. 
You may set or change the value of the &DOS special variable for your 


own use; if you do so, however, you will not be able to test whether the 
CMS/DOS environment is active. 


& EXEC 


The &EXEC special variable is the filename of the EXEC file. You cannot 
set this variable explicitly but you can examine and test it. 


& GLOBAL 


The &GLOBAL special variable contains the recursion level of the EXEC 
currently executing. Since the EXEC interpreter can handle upto 19 
levels of recursion, the value of &GLOBAL ranges from 1to 19. You 
cannot set this variable explicitly, but you can examine and test it. 
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& GLOBALn 


The &6GLOBALn special variable represents the variables &GLOBALO through 
&GLOBAL9. You can set these variables only to integral numeric values. 
They are all initially set to 1. Unlike other EXEC variables, these can 
be used to communicate between different recursion levels of the EXEC 
interpreter. 


& INDEX 


The &6INDEX special variable contains the number of arguments passed to 
the EXEC procedure. Since up to 30 arguments can be passed to an EXEC 
procedure, the value of SINDEX can range from 0 through 30. 


Although you cannot set this variable explicitly, it is reset by an 
GARGS or &READ ARGS control statement. S6INDEX can be examined to 
determine the number of active arguments in the EXEC procedure. 


& LINENUM 


The &LINENUM special variable contains the current line number in the 
EXEC file. You cannot explicitly set this variable but you can examine 
and test it. 


& READFLAG 


The &READFLAG special variable contains one of two literal values: 
CONSOLE or STACK. If there are stacked lines in the program stack or 
terminal input buffer GSREALFLAG contains the value STACK and the next 
read request results in a line being read from the stack. If not, then 
the next read request results in a physical read to the terminal, and 
the value of &READFLAG is CONSOLE. You cannot explicitly set this 
variable but you can examine and test it. 


& RETCODE 


The &RETCODE special variable contains the return code from the most 
recently executed CMS command. SRETCODE can contain only integral 
humeric values (positive or negative), and is set after each CMS command 
is executed. You can examine, test, and change this variable but 
changing it is not recommended. 


& TYPEFLAG 


The &TYPEFLAG special variakle contains one of two literal values: RT 
(cesume typing) or HT (halt typing). It contains the value HT when 
terminal display has been suppressed by the Immediate command HT. It 
contains the value RT when the terminal is displaying output. You 
cannot explicitly set this variable, but you can examine and test it. 
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Section 6. CMS Functions 


This section describes functions that are avilable to the CMS user. 


Execute CMS functions from application programs by setting up a 
parameter list and then issuing an SVC 202. When you want to execute a 
function in your program, load the address of the function parameter 
list into Register 1 and issue the SVC 202 as follows: 


LA 1,Parameter List 
SVC 202 
DC AL4Y (ERROR) 


where ERROR, is a routine to handle nonzero return codes returned in 
register 15 after execution of the SVC call. 


If you want to ignore errors, you can code the sequence: 


LA 1,Parameter List 
SVC 202 
DC AL4 (1) 


If the function completes normally, this sequence causes execution of 
the next seguential instruction. However, if an error occurs while 
executing the function and the program requires successful execution of 
the function, abnormal termination of your program may result. 
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ATTN Function 


Use the ATTN function to insert a line of input into the program stack. 
ATIN may be executed from an assembler language program via SVC 202 with 
the following parameter list: 


PLIST DS OD 

pc CL8*ATIN® 

DC CL4 *order* where order may be LIFO or FIFO. 
* FIFO is the default 

DC AL1 (length) length of line to be stacked 

Dc AL3 (addr) address of line to be stacked 


Usage Notes; 


1. 


2. 


The line that ATIN stacks is extracted from the program stack when 
WAITRD is executed to read a iine of input. (See the WAITRD 
function description for details of WAITRD function.) 


ATTN stacks lines of up to 255 characters. 


Responses 


None 


Return Codes 


Code 


25 


Meaning 


Function successfully completed 
No more storage 
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NUCEXT Function 


The nucleus extension function (NUCEXT) allows the user to identify 
command entry points in frograms established in free storage, _ so that 
they may be called by a SVC 202 as if they were nucleus commands. They 
thus become nucleus extensions. 


NUCEXT builds a chain of SCBLOCKS in storage for nucleus resident 
routines ({look-aside entries) and nucleus extensions. The first time a 
CMS nucleus resident function is invoked an SCBLOCK is added _ to the 
chain. 


The chain of nucleus extensions and look-aside entries is reordered 
each time a command is found on the chain. The reordering puts the most 
freguently used commands at the beginning of the chain. 


NUCEXT is a name given to a group of commands that all make use of an 
internal function named NUCEXI. The actual commands provided for 
Manipulation of nucleus extensions are: 


1. NUCXLOAD Loads an ADCON-free or relocatable nodule 
into free storage and installs it as a nucleus 
extension. 

2e NUC XDROP Cancels a nucleus extension and releases 


the corresponding storage. 


ae NUCXMAP Prints on the console or stacks a list of 
the nucleus extensions. 


Use NUCEXT to access uSer-written programs without having to do disk 
read operations (as would ke required for modules) or to avoid 
thrashing in the transient or user areas when several programs are used 
repeatedly (the same programs are loaded many times). 


Use NUCEXT for statistics gathering, filtering commands for various 
purposes, creating anchors for data kept in free storage until the next 
CMS IPL, and special operations during CMS abnormal end processing. 


Unlike transient routines or user programs, nucleus extensions are 
retained until they are unloaded explicitiy, or as aside effect of 
abnormal end cleanup for those using free storage of type 'user" (which 
is reclaimed during an abnormal end) or which are not designated as 
system routines to survive aknormal end. 


Nucleus extensions can have the same name as existing CMS nucleus 
commands or functions. If they do the extensions override the existing 
nucleus commands or functions. Only nucleus functions invoked via SVC 
202 can be overridden. ‘Two existing nucleus functions, however, RDBUF 
and WRBUF, can not be overridden. 
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Nucleus Extensions and Abnormal Fads 
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Types 


There are two types of nucleus extensions differentiated by their 
behavior during a CMS abnormal end. These two types are "system" and 
"user." The former will survive an abnormal termination of a user 
program (abnormal end), whereas the latter will not. Because CMS 
reclaims all storage of type "user" during the abnormal end cleanup 
Fhase, any nucleus extension in "“user" storage is deleted during 
abnormal end, regardless of its "system" attribute. 


Because of this storage reclamation during abnormal end, programs 
which build data structures in free storage of type ‘user' but keep 
pointers in storage of type 'system' need to know when abnormal end 
cleanup occurs (e.g., after HX). 


Service Calls: PURGE and RESET 


A program's need to know about abnormal end cleanup is supported by 
the idea of a service call. When a nucleus extension is declared (via 
NUCEXT), it may request that it receive a service call under appropriate 
circumstances. There are two standard service calls supported by 
NUCEXT. The PURGE service call is issued during CMS abnormal end 
cleanup. The RESET service call is issued by the NUCXDROP program when 
a nucleus extension iS explicitly unloaded. The service calls ailow 
programs with several entry points to cancel these at the same time, or 
to free storage areas. 


A note on service calls during an abnormal end: Do not stack during a 
service call. This causes the system to allocate storage that is not 
accounted for during abnormal end. The sequence of events’ that occur 
during an abend are documented in the VM/SP System Programmer's Guide 
under CMS abend recovery. 


The SYSTEM and SERVICE Attributes 


Nucleus extensions may or may not have the "SYSTEM" attribute and/or 
the "SERVICE" attribute. These attributes determine the handling of a 
nucleus extension during abnormal end processing. 


If a nucleus extension has the "SYSTEM" attribute, it remains active 
after an abnormal end. It is the user's responsibility to see that such 
a nucleus extension is loaded into nucleus storage, not user storage 
(which is recovered after an abnormal end). 


If a nucleus extension has the "SERVICE" attribute, it is called 
during abnormal end processing with the parameter list: 


DS OF 

DC CL8"*NUCLEUS EXTENSION NAME* 
DC CL8*PURGE* 

DC SX*FF* 


The high order byte in register 1 is set to X'FF*. 


A nucleus extension may have the "SYSTEM" and "SERVICE" attributes in 
any combination. 
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Nucleus Storage 


During abnormal end recovery, nucleus storage used by aucleus 
extensions behaves as follows: 


1. When a nucleus extension has the "SYSTEM" attribute, it should be 
in nucleus storage and the length word is used by abnormal end 
recovery to account for the amount of storage used by that 
program. 


2. If a nucleus extension does not have the "SYSTEM" attribute but 
is in nucleus starage anyway, that storage will be recovered 
during abnormal end. 


When a nucleus extension obtains nucieus-type free storage other than 
what is accounted for by the origin and length fields in the SCBLOCK, it 
should either: 


1. Use the "SERVICE" flag so that it is called with the PURGE 
parameter list during abnormal end, at which time it returns any 
hucleus-type storage it obtained (but not that described in its 
SCBLOCK) . 


2. If it has the "SYSTEM" attribute, account for any extra nucleus 
storage which is to be kept through an abnormal end by adding the 
length in doublewords of such storage into the NUCXFRES field in 
NUCON. It's a good idea to update this field as soon as the 
storage is obtained. This is required if the nucleus extension 
does not have the "SERVICE" attribute. 


Nucleus extensions remain in effect until cancelled, either 
explicitly or implicitly. Implicit cancellation normally occurs only 
for nucleus extensions of the ‘user' type (during an abnormal end 
cleanup time when all storage of ‘user' type is reclaimed). Explicit 
cancellation does not release the storage (if any) occupied by the 
nucleus extension: that is the responsibility of the program that issues 
the cancellation (usually the program NUCXDROP). 


Using the NUCEXT function affects the command resolution strategy of 
DMSITS when a SVC 202 is processed. Nucleus extensions are sought 
before functions in the real CMS nucleus (i.e., one which is defined by 
an entry in DMSFNC). This gives the user the ability to intercept, 
filter, augment, etc., the ‘real* nucleus functions. 


Linkage Conventions 
important Information for the NUCEXT Function 
When a nucleus extension is declared, the following information must 
ke provided: 
e The NAME of the command implemented by the nucleus extension. 
e The PSW to be used when passing control to the nucleus extension. 


e The address and length of the storage area occupied by the progran. 
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e Flag bits to indicate either type ‘user' or ‘systen,' and indicate 
whether service calls are desired. 


Secondary entry points are declared by indicating a storage size of 
zero. The PSW specifies the system mask, the PSW key to. be used, the 
program mask (and initial condition code), and the starting address for 
execution. The problem-state and wait-state bits may be set, but that 
would be useful only in very exceptional circumstances. The 
machine-check bit has no effect in CMS under CP, and the EC-mode cannot 
be set (it is always forced to zero). The flag bits are encoded in the 
third byte of the PSW. Also, one byte of user defined flags and one 
4-byte user-defined word can be associated with the nucleus extension, 
and referred to when the entry foint is suksequently called. 


Entry into a Nucleus Extension 


On entry to a nucleus extension, the register contents are: 


RO Address of extended parameter list (if 
one was provided by the cailer). 

R1 Address of the command name (and the 
tokenized parameter list). 

R2 Address of SCBLOCK with NUCEXT extension. 

R12 Entry pcint address. 

R13 24-word save area address. 

R14 Return address (CMSRET). 

R15 Entry pcint address. 


This is the standard entry point convention except that R2 points to 
the SCBLOCK. 


The NUCEXT function gueries, declares, Or cancels user nucleus 
extensions. NUCEXT can be issued as a command only for its query 
function. With one argument, ‘name, it returns either: 


0 "‘name' resolved to a user nucleus extension (found it). 
Or 
1 "‘name' not found. 
PLISTs 


As a function (called from a program), NUCEXT takes the following 
PLIST: 


Declared PLIST: 


NUCX DS OF PLISI TO DECLARE NUCLEUS EXTENSION 
DC CL8*NUCEXT? 

NUCXNAME DC CL8'name' COMMAND NAME 

NUCXPSW DC XL2*0000',AL2(0) SYSTEM MASK, STORAGE KEY, ETC 

NUCXADDR DC A(*-*) ENTRY ADDRESS, -1 for QUERY 
pC A(0) USER WORD 

NUCXORG DC A(*-*) LOAD ADDRESS 

NUCXLEN DC A(*-*) SIZE, IN BYTES 
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This declares ‘name' as a nucleus extension and puts an SCBLOCK at 
the head of the NUCEXT chain. The name may already be defined, in 
which case the previous declaration will be hidden until the present one 
is cancelled. Return code 25 means not enough storage was available to 
allocate the necessary SCBLOCK. 


The third and fourth bytes of the start-up PSW (interrupt code) are 
used as flag bytes. The format of the PSW is: 


AL1(system mask) (EC-mode bit forced to 0) 
AL.4 (storage key) 
BL.4'OMWP! 


AL1(NUCEXT flags) System=X'80!, 
Service=X'"40' 
AL1(user flag) May be used for private 
purpose. 


A(entry point) 
Cancel PLIST: 


CL8"*NUCEXT® 

CL8' name? 

XL4'irrelevant' 

A(0) identifies the cancel function 


This cancels the nucleus extension or gives a return code of 1if 
‘name’ is not found. The storage occupied by the program calling for 
this nucleus extension is not freed. This is the responsibility of the 
cancelling progran. 


Query PLIST: 


CL8"*NUCEXT® 

CL8' name! 

XL4*irrelevant' Receives A(SCBLOCK). 
XL4O*FFFFFFFF' identifies the query function 


This form returns the address of the SCBLOCK if 'namet is found, 
otherwise it changes nothing and gives a return code of 1. 


Note that if 'NUCEXT name' is called from a command level or from an 
EXEC file, the Query PLIST is the form of PLIST which will be issued. 
Get Anchor PLIST: 


CL8"* NUCEXT'® 


CL8'irrelevant'! 
A (*-*) Receives value (not address) 
of NUCEXT list anchor or O if 
there are no nucleus extensions. 
A (1) Indicates reguest for anchor. 


Notes The QUERY function does not locate ‘look-aside' entries. They 
can only be located by following the SCBLOCK chain using the 
anchor. 
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WAITRD Function 


Use the WAITRD function to read a line of input from the program stack 
or terminal input buffer into a specified buffer. WAITRD may be 
executed from an assembler language program via SVC 202 with the 
following parameter list: 


PLIST DS OF 
DC CL8*WAITRD* 
Dc —Fr:—s AL 11) 
DC AL3 (input buffer address) 
DC CL1'code' 
DC AL3 (number of bytes) - See Usage Note 1 


WAITRD first exhausts the program stack, then automatically Switches 
to the terminal input buffer. WAITRD does not perform logical line 
editing on lines read fron the program stack (unless uppercase 
translation is requested). WAITRD does perform logical line editing on 
lines read from the terminal input buffer, unless you specify code X. 
WAITRD does not perform logical line editing if you specify code X. 


The following codes specify what kind of processing WAITRD performs 
on lines read from the terminal input buffer. With these codes you must 
specify a buffer length of 130 bytes in the 'number of bytes' field in 
the WAITRD parameter list. 


Code Meaning 


U Reads a logical line, pads it with blanks, and translates it to 
uppercase. 
V Reads a logical line and translates it to upper case; does not 


pad with blanks. 


S Reads a logical line and pads it with blanks. 

T Reads a logical line; does not pad with blanks. 

X Reads a physical line. 

Y Reads a logical line, pads with blanks to 130, does no uppercase 


translation and does not do SET INPUT translation. 


The following codes specify what kind of processing WAITRD performs 
on lines read from the frogram stack. Indicate the length of the input 
buffer as the last parameter in the WAITRD parameter list. The length 
of the input buffer may be uf to 255 bytes. 


Code Meaning 


W Reads a physical line; performs no uppercase translation or 
padding with rlanks. 


Z Reads a physical line and translates it to upper case; does not 
pad with blanks. 


Use the following codes when you use APL under CMS. Indicate the 


length of the input buffer as the last parameter in the WAITRD parameter 
list. The length of the Euffer may be up to 2030 bytes. 
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WAITRD Function 


Meaning 


Reads a physical line into the caller's buffer. (See Usage Note 
4.) 


Reads a physical line into the caller's buffer. (See Usage Note 
4.) 


Usage Notes 


1. 


Specify the input buffer length as the last parameter in the WAITRD 
parameter list. Upon completion of the WAITRD function, the 
"number of bytes! field contains the number of bytes read. 


WAITRD does not perform logical line editing when reading a 
physical line. 


WAITRD performs line editing on lines read from the terminal input 
buffer (lines typed at the terminal), unless code X is specified; 
WAITRD does not perform logical line editing when you specify code 
X. WAITRD does not perforn line editing (except uppercase 
translation, if requested) on lines read from the program stack. 


Lines typed at the terminal (and stacked in the terminal input 
buffer) are scanned by CP for logical line editing characters. 
Logical line editing characters are set by the CP TERMINAL command. 
The line editing characters may te set for: 


Chardel 
Linedel 
Linend 
Escape 


In addition, CMS scans the lines for the two following hexadecinal 
characters: 


X'15" - interpreted as the end of the physical line. Any 
character(s) to the fright of this hexadecinal 
character is ignored. 


X'O0O" - interpreted as the end of the logical line. Any 
character(s) to the right of this hexadecimal 
character is interpreted as a new line. 


For code $, an attention interrupt during a read operation signals 


the end of the line and does not result ina restart of the read. 
For code *, an attention interrupt during a read results in a 
restart of the read operation. 


Responses 


None 


Meaning 

Function completed successfully. 

Invalid code. Read not completed. 

Code=$. An attention interruption ended the read operation. 
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Section 7. CMS Macro Instructions 


This section describes the formats of the CMS assembler language macros, 
which you can use when you write assembler language programs to execute 
in the CMS environment. To assemble a program using any of these 
macros, you must issue the GLOBAL command specifying MACLIB DMSSP CMSLIB 
which are the macro libraries (located on the system disk) which contain 
CMS macros. 


For functional descriptions and usage examples of the CMS macros, see 
the VM/SP CMS User's Guide. 


Coding conventions for CMS macros are the same as those for all 
assembler language macros. The macro format descriptions show optional 
operands in the format: 


[ ,operand ] 


indicating that if you are going to use this operand, it must be 
preceded by a comma (unless it is the first operand coded). If a macro 
statement overflows to a second line, you must use a_ continuation 
Character in column 72. No blanks May appear between operands. 
Incorrect coding of any macro results in assembler errors and MNOTEs. 


Where applicable, the end of a macro description contains a list of 
the possible error conditions that may occur during the execution of the 
Macro, and the associated return ccdes. These return codes are always 
placed in register 15. The macros that produce these return codes have 
ERROR= operands, that allow you to specify the address of an error 
handling routine, so that you can check for particular errors during 
macro processing. If an error occurs during macro processing and no 
error address is provided, execution continues at the next seguential 
instruction following the macro. 
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COMPSWT 


Use the COMPSWT macro instruction to turn the compiler switch (COMPSWT) 
flag on or off. The COMPSWT flag is in the OSSFLAGS byte of the nucleus 
constant area (NUCON). The format of the COMPSWT macro instruction is: 


| as Sa I a a Ba a a aaa aaa a | 
| {label] | COMPSWT | ON | 
i | OFF | 


label is an optional statement lakel. 


ON turns the COMPSWT flag on. When this flag is on, any progran 
called by a LINK, LOAD, XCTL, or ATTACH macro instruction must 
be a nonrelocatable module ina file with a filetype of MODULE; 
it is loaded via the CMS LOADMOD command. 


OFF turns the COMPSWI flag off. When this flag is off, any progran 
called by a LINK, LOAD, XCIL, or ATTACH macro instruction must 
be a relocatable object module residing in a file with a 
filetype of TEXT, LOADLIB, ox TXTLIB; it is loaded via the CMS 
INCLUDE command. 


FSCB 


Use the FSCB macro instruction to create a file system control block 
(FSCB) for acCMS input or output disk file. The format of the FSCB 
Macro instruction is: 


Gra eS Pe ee Pee ge ee OER ne me ee ene oe ee ep ee, ee ee eg eee 
| [label] | FSCB | [fileid] [,RECFM=format] [,BUFFER=buffer ][ ,FORM=E] | 


i | | [,BSIZE=size ] [, RECNO=number ] [ , NOREC=nunmrec ] { 
On ae eee ee ee Se ee ee ee eee 
where: 

label is an optional statement label. 

fileid specifies the CMS file identifier, which must be enclosed 


in single guotation marks and separated by blanks 
(‘filename filetype filemode'). If filemode is omitted, 
Al is assumed. 


RECFM=format indicates whether the records are fixed- (F) or variable- 
(V) length format. The default is F. 


BUFFER=buffer specifies the address of an I/0 buffer, from which 
records are to be read or written. 


FORM=E specifies the extended format FSCB is to be generated. 
This extended format FSCB allows you to specify a value 
(up to 231-1) for RECNO and NOREC. If you do not specify 
FORM=E, the RECNO and NOREC values cannot exceed 65533. 
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FSCB, FSCBD Macros 


BSIZE=size Specifies the number of bytes to be read or written for 
each read or write reguest. 


RECNO=number Specifies the record number of the next record to be 
accessed, relative to the beginning of the file, record 
1. The default is 0, which indicates that records are to 
be accessed sequentially. 


NOREC=numrec Specifies the number of records to he read in the next 
read operation. The default is 1. 


Usage Notes 


1. The options RECFM, BUFFER, BSIZE, RECNO, and NOREC must all be 
specified as self-defining terms. 


2. You can use the same FSCB to reference several different files; you 
can override the fileid, or any of the options, on the FSOPEN, 
FSWRITE, or FSREAD macro instructions when you reference a file via 
its FSCB. However, if the FSOPEN macro instruction is used to 
ready an existing file, the BSIZE and RECFM fields in the FSCB are 
reset to reflect actual file characteristics. 


3. You can use multiple FSCBs to reference the same file, for example, 
if you wanted one FSCB for writing and a different FSCB for reading 
the file. Keep in mind, however, that the file characteristics are 
inherent to the file and not to the FSCB. If you establish a read 
Or write pointer using the RECNO option in one FSCB, that pointer 
remains unchanged unless you specify the RECNO option again on the 
Same or any other FSCB for that file. 


FSCBD 


Use the FSCBD macro instruction to generate a DSECT for the file systen 
control block (FSCB). The format of the FSCBD macro instruction is: 


Se ee 
| [label] | FSCBD | l 
a ee a eee 


label is an optional statement label. The first statement in the 
FSCBD macro expansion is lakeled FSCBD. 


Usage Notes 


1. You can use the labels established in the FSCB DSECT to modify the 
fields in an FSCB for a particular file. An FSCB iS created 
explicitly by the FSCB macro instruction, and implicitly by the 
FSREAD, FSWRITE, and FSOPEN macro instructions. 
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FSCBD Macro 


2. The FSCBD macro instruction expands as follows: 


FSCBD 
FSCBD DSECT 
© FSCBCOMM ODS CL8 Command 
& FSCBFN DS CL8 Filename 
{& FSCBFT DS CL8 Filetype 
1@ FSCBFM DS CL2 Filemode 
1% FSCBITNO DS H Relative record (iten) number 
'G FSCBBUFF DS A Address of read/write buffer 
FSCBSIZE DS F Length of buffer 
FSCBFV DS CL1 Record format (F or V) 


FSCBFLG DS 
FSCBNOIT ODS 
FSCBNORD ODS 
FSCBAITN ODS 
FSCBANIT DS 
FSCBWPTR DS 
FSCBRPTR DS 


PLIST flag 

Number of records to be read/written 
Numker of bytes actually read 
Extended item number 

Extended number of items 

Write pointer 

Read pointer 


he rj hr be OO bd 


3. If you specify FORM=E as_ the parameter of the FSCB macro 
instruction, the fields FSCBITNO and FSCBNOIT are no longer used. 
They are replaced with FSCBAITN and FSCBANIT. The X'20* bit of the 
FSCBFLG flag is turned on. The fields FSCBWPTR and FSCBRPTR are 
used by the FSPOINT function. FORM=E plists must be used to 
Manipulate files larger than 65,533 items. 
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FSCLOSE 


Use the FSCLOSE macro instruction to close an open file. The format of 
the FSCLOSE macro instruction is: 


a eee a ee Se ee ve ee ee 
| [label] | FSCLOSE | Seay aaa [, ERROR=erraddr ] | 
4 | I FSCB=fscb 


label is an optional statement label. 
fileid specifies the CMS file identifier. It may be: 


"fn ft fm' fileid enclosed in single quotation marks and 
separated by blanks. If fm is omitted, Al is 
assumed. 

(reg) a register other than 0 or 1 containing the 
address of the fileid (18 characters). When 
register format is used, the fileid must be 
exactly 18 characters in length; 8 for _ the 
filename, 8 for the filetype, and 2 for the 
filenode. Shorter names must be filled with 
blanks. 


FSCB=fscb specifies the address of an FSCB. It may be: 


label the label on the FSCB macro instruction. 
(reg) a register containing the address of an FSCB. 


ERROR=erraddr 
specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 


Although CMS routines close files when a command or progran 
completes execution, you must use the FSCLOSE macro instruction 
when you are executing a program from within an EXEC, or when you 
are going to read and write records in the same file. 


ze If you specify both fileid and FSCB, the fileid is used to fill in 
the FSCB. 


3. Even though an FSCLOSE macro is issued for a file, the directory is 
not updated on disk as long as there are other files open for 
output on that disk. 

Error Conditions 


If an error occurs, register 15 contains the following error code: 


Code Meaning 
6 File is not open or no read or write was issued to file. 
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FSERASE 


Use the FSERASE macro instruction to delete a CMS disk file. The format 
of the FSERASE macro instruction is: 


Dg ee Ee Ty RE ae tee Ee Oe ees fae ge ee ge ene ee ocean Pee eee are eee ee ae 
| [label] | FSERASE | f{ fileid[ ,FSCB=fscb] | [,ERROR=erraddr] | 
| ) FSCB=fscb 


label is an optional statement label. 
fileid specifies the CMS file identifier. It may be: 


"fn £t fm*' fileid enclosed in single quotation marks’ and 
separated by blanks. If fm is omitted, Al is 
assumed. 

(reg) a register other than 0 or 1 containing the 
address of the fileid (18 characters). When 
register format is used, the fileid must be 
exactly 18 characters in length; 8 for the 
filename, 8 for the filetype, and 2 for the 
filemode. Shorter names must be filled with 
blanks. 


FSCB=fscb specifies the address of an FSCB. It may be: 


label the label of an FSCB macro instruction. 
(reg) a cregister containing the address of an FSCB. 


ERROR=erraddr 
specifies the address of an error routine to be given control 
if anerror occurs. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 


Usage Notes 
1. On return from the FSERASE macro, register 1 points to a parameter 
list. The second, third, and fourth words of the list contain the 
filename, filetype, and filemode of the file. 


2. If fileid and FSCB= are both coded, the fileid is used to fill in 
the FSCB. 


Error Conditions 


If an error occurs, register 15 contains one of the following error 
codes; 


Code Neaning 
24 Parameter list error 
28 File not found 
36 Disk not accessed 
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FSOPEN 


Use the FSOPEN macro instruction to ready a file for either input or 
output. The format of the FSOPEN macro instruction is: 


SS 
| [label] | FSOPEN | fileid [ , FSCEB=fscb ] \ [, ERROR=erraddr][ ,options]}| 
i | FSCB=f£scb [ »FORMN=E J 


where; 
label is an optional statement label. 
fileid specifies the CMS file identifier. It may be: 


‘fn ft fm*' the fileid enclosed in single quotation marks and 
separated by blanks. If fm is omitted, Al is 
assumed. 

(reg) a register other than 0 or 1 containing the 
address of the fileid (18 characters). When 
register format is used, the fileid must be 
exactly 18 characters in length; 8 for the 
filename, 8 for the filetype, and 2 for the 
filemode. Shorter names must be filled with 
blanks. 


FSCB=fscb specifies the address of an FSCB. It may be: 


label the label on an FSCB macro instruction. 
(reg) a register containing the address of an FSCB. 


ERROR=erraddr ; 
specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 


FORMN=E Must be specified when the extended format is being used. 


Options 


You can specify any of the following FSCB macro options on the FSOPEN 
Macro instruction: 


BUFFER=buffer 
RECNO=number 
BSIZE=size 
RECFM=format 
NOREC=numrec 


These options may ke specified either as the actual value (for 
example, NOREC=1) or aSa register that contains the value (for 
example, NOREC=(3) where register 3 contains the value 1). 


When you use any of these options, the associated field in the 
FSCB is modified. 
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Usage Notes 


Vs 


On return from the FSOPEN macro, register 1 foints to the FSCB for 
the file. If no FSCE exists, one iS created in the FSOPEN macro 
expansion. However, if the FSOPEN macro instruction is used to 
ready an existing file, the FESIZE and RECFM fields are reset to 
reflect actual file characteristics. 


If you code both fileid and FSCB=, the fileid is used to fill in 
the FSCB. 


You can use the FSOPEN macro instruction to verify the existence of 
a file to be opened for reading or writing, and you can use FSOPEN 
to create an FSCB for that file. 


— a 2 a ES Eo ED 


If an error occurs, register 15 contains one of the following error 
codes; 
Code Meaning 
20 Invalid file identifier 
28 File does not exist 
FSPOINT 
Use the FSPOINT macro instructicn to reset the write and/or read 


pointers for a file. The format of the FSPCINT macro instruction is: 


gota le 
[label] | FSPOINT 


aa a ads 
a aa! | 
FSCB=fscb 


; 
l l 
| [ ,WRPNT=wrpnt | [,RDPNT=rdpnt ] [,FORM=E } l 


EE eee a I eee 


where: 


label 


1S an optional statement latel. 


fileid specifies the CMS file identifier. It may be: 


FSCB= 


ERROR 
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'fn ft fm*' the fileid enclosed in guotation marks and 
separated by blanks. If fm is omitted, Al is 
assumed. 

(reg) a register other than 0 or 1 containing the 
address of the fileid (18 characters). 


fscb specifies the address of an FSCB. It may be: 


label the label of an FSCB macro instruction. 
(reg) a register containing the address of an FSCB. 
=erraddr 


Specifies the address of an error routine to be given control 
if an error is found. If you don't code ERROR= is not coded 
and an error occurs, control returns to the next sequential 
instruction in the calling program, as it does if no error 
occurs. 
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WRPNT=wrpoat specifies the new value of the write pointer. 
number any assembler symbol cr number. 
(reg) a register containing the binary number. 


RDPNT=rdpnt 
specifies the new value of the read pointer. 


number any assembler symbol or number. 
(reg) a register containing the binary number. 
FORM=E must be specified when the extended format FSCB is being used. 


Usage Notes 
a4 
1. Both write and read fointers may be changed at the same time, and 
zero indicates no change. 


2. Minus one used for a write pointer indicates that the next item is 
to be put at the end of the file. 


Error Conditions 


If an error occurs, register 15 contains one of the following error 
codes: 


Code Meaning 
20 Invalid character in fileid 
24 Invalid filemode 
28 File not found 
36 Disk not accessed 


FSREAD 


Use the FSREAD macro instruction to read a record from a disk file into 
an I/O buffer. The format of the FSREAD macro instruction is: 


ae ae Aer ek eee RE ee Ea ee RCRD RE ES aE ae 
| [label] | FSREAD | { fileid[ ,FSCB=fscb ] ee [,FORM=E] | 
l l ; FSCB=fsck [, options ] 


where: 
label is an optional statement label. 
fileid specifies the CMS file identifier. It may be: 


"fn ft fm' the fileid enclosed in single gquotation marks and 
separated by blanks. If fm is omitted, Al is 
assumed. 

(reg) a register other than 0 or 1 containing the 
address of the fileid (18 characters). When 
register format is used, the fileid must be 
exactly 18 characters in length; 8 for the 
filename, 8 for the filetype, and 2 for the 
filemode. Shorter names must be filled with 
blanks. 
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FSCB=fscb specifies the address of an FSCB. It may be: 


label the label of an FSCB macro instruction. 
(reg) a register containing the address of an FSCB. 


ERROR=erraddr 


specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 


FORM=E 


must be specified when the extended format FSCB is being used. 


Options 


You can specify any of the following FSCB macro options on the FSREAD 
macro instructions 


BUFFER=buffer 
NOREC=nunrec 
BSIZE=size 
RECNO=number 


These options may be specified either as the actual value (for 
example, NOREC=1) or aS a register that contains the value (for 
example, NOREC=(3) where register 3 contains the value 1). 


When you use any of these options, the associated field in the 
FSCB is modified. 


Usage Notes 


1. 


468 


If an FSCB macro instruction has not keen coded for a file (and the 
FSCB= operand is not coded), you must specify the BUFFER= and 
BSIZE= options to indicate the address of the buffer and its 
length. When reading variable-length records, a record that is 
longer than the buffer length is truncated. FSREAD does not clear 
the buffer when the record length iS not the maxinua. 


On return from the FSREAD macro, register 1 points to the FSCB for 
the file. If no FSCB exists, one is created following the FSREAD 
macro instruction. 


If you specify both fileid and FSCB=, the fileid is used to fill in 
the FSCB. 


Register 0 contains, after the read operation is complete, the 
number of bytes actually read. This information is also contained 
in the FSCBNORD field of the FSCB. Only when zero records are read 
is the EOF raised on a multiple record read. EOF is not raised 
when a partial read occurs due to less records remaining than 
requested. 


To read records seguentially beginning with a particular record 
humber, use the RECNO option to specify the first record to be 
read. On the next FSREAD macro instruction, use RECNO=0- so that 
reading continues sequentially following the first record read. 
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Error Conditions 


If an error occurs, register 15 contains one of the following error 
codes: 


C 


de Meaning 

1 File not found 

2 Invalid buffer address 

3 Permanent I/Q error 

5 Number of records to be read is less than or egual to zero 
(or greater than 32,768 for an 800-byte formatted disk) 


7 Invalid record format (only checked when the file is first 
opened for reading) 
8 Incorrect length -buffer size too small for item read. 
9 File open for output (for an 800-byte formatted disk) 
11 Number of records greater than 1 for variable-length file 
12 End of file, or record number greater than number of records 
in data set 
13 Variable-length file has invalid displacement in active file 
table 
14 Invalid character in filename 
15 Invalid character in filetype 
25 Insufficient free storage available for file management 
control areas. 
26 Requested item number is negative or item number plus number 


of items exceeds file system capacity. 


FSSTATE 


Use the FSSTATE macro instruction to determine whether a particular file 
exists. The format of the FSSTATE macro instruction is: 


—... pete oe ease ok bea eee ee ees Se eee ee ge Oe Le eae ee ee et eee Oe ge ge ee oe 
| [label] | FSSTATE | fileid Eeeev eared [ ,ERROR=erraddr ] | 
i | FSCB=fscb [ ,FORM=E ] | 


where: 
label 1s an optional statement lakel. 
fileid specifies the CMS file identifier. It may be: 


'fn ft fm" the fileid enclosed in single quotation marks and 
separated by blanks. If fm is omitted, Al is 
assumed. 

(reg) a register other than 0 or 1 containing the 
address of the fileid (18 characters). When 
register format is used, the fileid must be 
exactly 18 characters in length; 8 for the 
filename, 8 for the filetype, and 2 for the 
fiiemode. Shorter names must be filled with 
blanks. 


FSCB=fscb specifies the address of an FSCB. It may be: 


label the label on an FSCB macro instruction. 
(reg) a register containing the address of an FSCB. 
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FSSTATE Macro 


ERROR=erraddr 
Specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 


FORM=E 
must be specified when the extended format FSCB is being used. 
Usage Notes 
1. If the specified file exists, register 15 contains a 0 return code. 


2. When the FSSTATE macro completes execution, register 1 contains the 
address of the file status table (FST) for the specified file. 


The file status table contains the following information: 


Decimal 
Displacement Field Description 


0 Filenane 

8 Filetype 

16 Date (mmdd) last written 

18 Time (hhmm) last written 

20 Write pointer (number of iten) 
22 Read pointer (number of iten) 
24 Filenode 
26 Number of records in file 

28 Disk address of first chain link 
30 Record format (F/V) 

31 FST Flag Byte 

32 Logical record length 

36 Number of 800-byte data blocks 
38 Year (yy) last written 


For Form=E the following are included; 


Decimal 
Displacement Field CLescription 


40 Alternate file origin pointer 

qy Alternate number of data blocks 

48 Alternate item count 

52 Number of pointer block levels 

53 length of pointer element 

54 Alternate date/time (yy mm dd hh nom Ss) 
60 Reserved 


= ome Eee oe ee 


If an error occurs, register 15 contains one of the following error 
codes: 


Code Meaning 
20 Invalid character in fileid 
24 Invalid filenode 
28 File not found 
36 Disk not accessed 
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FSWRITE Macro 
FSWRITE 


Use the FSWRITE macro instruction to write a record from an I/O buffer 
to a CMS disk file. The format of the FSWRITE macro instruction is: 


re ae a ee ee ee ey ee ee a Pe ee ee ee a ee ee 
| [label] | FSWRITE | peeeeeege  e [| , ERROR=erraddr ] i 
i i | FSCB=fscb [,FORM=E ] [,options ] | 


label is an optional statement label. 
fileid Specifies the CMS file identifier. It may be: 


'fn ft £m" the fileid enclosed in single quotation marks and 
separated by blanks. If fm is omitted, Al is 
assuned. 

(reg) a register other than 0 or 1 containing the 
address of the fileid (18 characters). When 
register format is used, the fileid must be 
exactly 18 characters in length; 8 for the 
filename, 8 for the filetype, and 2 for the 
filemode. Shorter names must be filled with 
blanks. 


FSCB=fscb specifies the address of an FSCB. It may be: 


label the label on an FSCB macro instruction. 
(reg) a register containing the address of an FSCB. 


ERROR=erraddr 
specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 


FORM=E 
must be specified when the extended format FSCB is being used. 


You can specify any of the following FSCB macro options on the 
FSWRITE macro instruction: 


BUFFER=buffer 
RECNO=number 
BSIZE=size 
NOREC=numrec 
RECFM=format 


These options may be specified either as the actual value (for 
example, NOREC=1) or as a register that contains the value (for 
example, NOREC=(3) where register 3 contains the value 1). 


When you use any of these options, the associated field in the FSCB 
for the file is filled in or modified. 
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Usage Notes 


If an FSCB macro instruction has not been coded for a file (and the 
FSCB= operand iS not coded on the FSWRITE macro instruction), you 
must specify the BUFFER= and BSIZE= options to indicate the 
location of the read/write buffer and the length of the record to 
be written. For the filemode, you must specify both a letter anda 
number. If the file is a variable-length file, you must also 
specify RECFM=V. 


On return from the FSWRITE macro, register 1 contains the address 
of the FSCB for the file. If no FSCB exists, one is created 
following the FSWRITE macro instruction. 


If you specify both fileid and FSCB=, the fileid is used to fill in 
the FSCB. 


If the RECNO option is specified (either on the FSWRITE macro 
instruction or in the FSCB), that specified record is written. 
Otherwise, the next sequential record is written. For new files, 
writing begins with record 1; for existing files, writing begins 
with the first record following the end of the file. 


To write records sequentially beginning with a particular record 
Number, use the RECNO option tc specify the first record to be 
written. On the next FSWRITE macro instruction, use RECNO=0 so that 
writing continues seguentially, following the first record written. 


To write blocked records (valid for fixed-length files only), use 
the BSIZE and NCREC options to specify the blocksize and number of 
records per blcck, respectively. For example, to write 80-byte 
records into 800-byte blocks, you should specify BSIZE=800 and 
NOREC=10. The buffer you use must be at least 800 bytes long. 


When you use the FSWRITE macro to update an existing file of 
variable-length records, the replacement record must be the sane 
length as the original record. An attempt to write a_ record 
Shorter or longer than the original record on a disk formatted with 
1k, 2k or 4k blocksize results in truncation of the file at the 
specified record number with no error return codes. An attempt to 
write a record shorter cr longer than the original record on a disk 
formatted as an 800 byte blocksize results in no change to the file 
and an error code of 27. 


Error Conditions 


If an error occurs, register 15 contains one of the following error 
codes: 
Code Meaning 
2 Invalid buffer address 
3 Permanent I/O Error 
- First character of filemode is invalid 
5 Second character of filemode is invalid 
6 Item number too large (more than 65,535) will not fit in 
a halfword, extended PLIST not specified. 
7 Attempt to skip over unwritten variable-length item 
8 Buffer size not specified 
9 File open for input (for an 800-byte formatted disk) 
10 Maximum number of files per minidisk reached (3400 for an 
800-byte formatted disk) 
11 Record format not F or V 
12 Attempt to write on read-only disk 
13 Disk is full 
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14 Number of bytes to be written is not integrally divisible 
by the number of records to be written 

15 Length of fixed-length item not the same as previous iten 

16 Record format specified not the same as file 

17 Variable-length item greater than 65K bytes 

18 Number of records greater than 1 for variable-length file 

19 Maximum number of data blocks per file reached (16060 for 
an 800-byte formatted disk) 

20 Invalid character detected in filenane 

21 Invalid character detected in filetype 

22 Virtual storage capacity exceeded 

25 Insufficient free storage available for file directory 
buffers 

26 Requested item number is negative or item number plus 
number of items exceeds file system capacity. 

27 Attempt to update variable length item with one of 


different length. 


HNDEXT 


Use the HNDEXT macro instruction to trap external interruptions and pass 
control to an internal routine for processing. External interruptions 
are caused, in a virtual machine, by the CP EXTERNAL command. The 
format of the HNDEXT macro instruction is: 


a a eae ney aT ne Ba FORE gg ee ye a OE et CE eae eg aay ie Rea Te ea SO gage een ee Re ee 
i [label] | HNDEXT | ee aa, i 
i CLR | 


where: 
label is an optional statement label. 
SET specifies that you want to trap external interruptions. 


address specifies the address in your program of the routine to be 
given control when an external interruption occurs. 


CLR specifies that you no longer want to trap external 
interruptions. 
Usage Notes 


1. External interruptions (other than timer interruptions) normally 
place your virtual machine in the debug environment. 


2- When your interruption handling routine is given control, all 
virtual interruptions, except multiplexer, are disabled. If you 
are uSing the CMS blip function, all blips are stacked. 


3. You are responsible for providing proper entry and exit linkage for 


your interruption handling routine. When your routine receives 
control, register 1 points to a save area in the format: 


Displacement 


Label Dec_ Hex 
GRS 0 0 
FRS 64 40 
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PSW 96 60 
UAREA 104 68 
END 176 FO 


Register 13 points to the user save area at label UAREA. 


Register 15 contains the entry point address of your routine; it 
must return control to the address in register 14. 


4. If you also issue a STAX macro instruction to handle attention 
interruptions while the HNDEXT macro is active, either exit may be 
interrupted while the other is running. If your exits depend on 
data in static areas, results are unpredictable. 


HNDINT 


Use the HNDINT macro instruction to trap interruptions for a specified 
I/O device. The format of the HNDINT macro instruction is: 


ce 


[label] | HNDINT i rae aa ee a 
0 WAIT 


| 
| 
| 
| CLR, (dev1)[, (dev2)[...]] 
| 
1 


[ ,ERROR=erraddr ] 


where: 

label is an optional statement label. 

SET specifies that you want to trap interruptions for the 
specified device. 

dev specifies a four-character symbolic name for the device whose 
interruptions are to ke trapped. 

addr specifies the address in your program of the routine to be 
given control when the interruption occurs. An address of 0 
indicates that interrupticns for the device are to be ignored. 

cuu specifies the virtual device address, in hexadecimal, of the 
device whose interruptions are to be trapped. 

AS AP specifies that the routine at addr is to be given control as 
soon as the interruption occurs. 

WAIT specifies that the routine at addr is to be given control 
after the WAITD macro is issued for the device. 

CLR specifies that you no longer want to trap interruptions for 


the specified device. HNDINT CLR should not be issued fron 
within the interrupticn handling routine. 


ERROR=erraddr 
specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 
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Usage Notes 


1. 


2 


HNDINT does not trap I/0O operations initiated by a DIAGNOSE 
instruction. 


In a single HNDINT macro instruction, you can define interruption 
handling routines for more than cne device. The argument list for 
each device must be enclosed in parentheses and separated from the 
next list by a comma. 


If you specify WAIT, then the routine at the specified address in 
your program receives control when a WAITD macro instruction that 
specifies the same symbolic device name is issued. If the WAITD 
macro instruction has already heen issued for the device when the 
interruption occurs, then the routine at the specified address 
receives control immediately. 


You are responsible for establishing proper entry and exit linkage 
for your interruption handling routine. When your routine receives 
control, the significant registers contain: 


Registers Contents 


0-1 I/O old PSW 

2-3 Channel status word (CSW) 
u Address of interrupting device 
14 Return address 
15 Entry pcint address 


Your routine must return contrcl to the address in register 14, and 
indicate, via register 15, whether processing is complete. A 0 in 
register 15 means that you are through handling the interruption; 
any nonzero return code indicates that you expect another 
interruption. 


The interruption handling routine that you code should not perforn 
any I/0 operations. When it is given control, all TI/0 
interruptions and external interruptions are disabled. 


Error Conditions 


If 


an error condition cccurs, register 15 will contain one of the 


following return codes: 


Code 
1 


Meaning 

Invalid device address (cuu) or interruption handling routine 
address (addr) 

Trap item replaces another of same device name 


Attempting to clear a nonexisting interruption 
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HNDSVC 


Use the HNDSVC macro instruction to trap interruptions caused by 
specific supervisor call (SVC) instructions. The format of the HNDSVC 
macro instruction is: 


[label ] 


HNDSVC | SET, (svcnum, address) [, (svcnum,address) ... ] 
[ CLR,svcnun[ ,svcnun... ] 
| 
| 


| 
| 
| 
| { ,ERROR=erraddr } 
a I ee ee ee 


where: 

label is an optional statement lahkel. 

SET Specifies that you want to trap SVCs of the specified 
number(s). 

svchun specifies the number of the SVC you want to trap. SVC numbers 


0 through 200 and 206 through 255 are valid. 


address specifies the address of the routine in your program that 
should receive control whenever the specified SVC is issued. 


CLR specifies that ycu no longer want to trap the specified 
SVC (Ss). 


ERROR=erraddr 
specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns tc the next sequential instruction in 
the calling program, as it does if no error occurs. 


Usage Note 


You are responsible for providing the proper entry and exit linkage for 
your SvVC-handling routine. When your program receives control, the 
register contents are as follows: 


Register Contents 
12 Address of your SVC-handling routine 
13 Address of an 18-fullword save area (for your use) 
14 Return address 


Your routine must return contrcecl to the address in register 14. 


If an error occurs, register 15 contains one of the following error 


Code Meaning 
1 Invalid SVC number or address 
2 SVC number set replaced previously set number 
3 SVC number cleared was not set 


476 IBM VM/SP CMS Command and Macro Reference 


LINEDIT Macro 


LINEDIT 


Use the LINEDIT macro instruction tc convert decimal values into EBCDIC 
or hexadecimal and to display the results at your terminal. The format 
of the LINEDIT macro instruction is: 


[ I l r 166 1° 2 | 
| [label] | LINEDIT | |,TEXT="messagetext' | |,DOT= LES MI comps {1Es\ 
| l | |, TEXTA=address 1 | 10 i NO Sy} 
| | | L J L J L J | 
| ; | [,SUB=(substitutionlist) ] | 
| | lr 166 1 | 
| | | |,DISP= ( TYPE | | , BUFFA=({ ea aa | 
[ | i | NONE i | \ (reg) ; | 
| | i | SIO (is 4 [ 
| | | | PRINT [ | 
| | 1 | CPCOMM\ | | 
| 1 | ERRMSG J | | 
| | { t 4 i 
| | ior 5, [ ,MAXSUBS=nunmber ] { 
| | { |,MF= {1 l | 
| [ | | L | ; 
| 1 Ser aa | | 
[ | [| (reg) | [ 
| | [| & 4 l 
{ { Ir 1 { 
| | |,RENT= { zest | 
[ { i | NO | [ 
| [ | 4 ( 


The LINEDIT macro operands are listed below, briefly. For detailed 
formats, descriptions, and examples, refer to the appropriate heading 
following “LINEDIT Macro Cperands." 


TEXT='message text’ 
specifies the text of the message to be edited. 


TEXTA=address 
specifies the address of the message text. It may be: 


label the symbolic address of the message text. 


(reg) a register containing the address of the message text. 

DOT specifies whether a period is to be placed at the end of the 
line. 

COMP specifies whether multiple blanks are to be removed from the 
line. 

SUB specifies a substitution list describing the conversions to be 


performed on the line. 


DISP specifies how the edited line is to be used. When DISP is not 
coded, the message text is displayed at the terminal. 

BUFFA specifies the address of the buffer in which the line is to be 
copied. 

MF specifies the macro format. 


Section 7. CMS Macro Instructions 477 


LINEDIT Macro 


MAXSUBS specifies the maximum number of substitutions (MAXSUBS is used 
with the list form of the macro). 


RENT specifies whether reentrant code must be generated. 


Usage Notes 


1. You should never use registers 0, 1, or 15 aS address registers 
when you code the LINEDIT macro instruction; these registers are 
used by the macro. 


2. When message text for the LINELDIT macro instruction contains two or 
more consecutive periods, it indicates that a substitution is to be 
performed on that portion of the message. The number of periods 
you code indicates the number of characters that you want to appear 
as output. To indicate what values are to replace the periods, code 
a substitution list using the SUE operand. 


3. When you use the standard (default) form of the LINEDIT macro 
instruction, reentrant code is produced, except when you specify 
more than one substitution list, or when you use register notation 
to indicate an address on the TEXTA or BUFFA operands. When any of 
these conditions occur, an MNOTE message is produced, indicating 
that the code is not reentrant. 


If you do not care whether the code is reentrant, you can specify 
the RENT=NO operand to suprress the MNOTE message. Otherwise, you 


can use the list and execute forms of the macro to write reentrant 
code (see "MF Operand"). 


Error Conditions 


Errors can only occur if DISP=CPCOMM is specified. In this case, R15 
contains the return code from the CP command. 


oe Ee a EE 


Use the TEXT operand to specify the exact text of the message on the 
macro instruction. The message text must appear within single quotation 
marks, as follows: 

TEXT='message text! 


If you want a single guotation mark to appear within the actual message 
text, you must code two of then. 


Text specified on the LINEDIT macro is edited so that multiple blanks 
appear as only a single tlank, and a period is placed at the end of the 
line, for example: 

LINEDIT TEXT="IT ISN*'T READY' 


results in the display: 
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IT ISN'T READY. 


TEXTA Operand 


Use the TEXTA operand when you want to display a line that is contained 
in a buffer. You may specify either a symbolic address or use register 
notation, as follows: 


pie ee 
(reg) 


In either case, the first byte at the address specified must contain the 
length of the message text, for example: 


LINEDIT TEXTA=MESSAGE 


MESSAGE DC X' 16! 
DC CL22'*THIS IS A LINE OF TEXT'® 


If you use register notation with either the standard or list forms of 


the macro, the code generated is not reentrant. To suppress the MNOTE 
that informs you that code is not reentrant, use the RENT=NO operand. 


DOT Operand 


Use the DOT operand when you do not want a period placed at the end of 
the message text. The format of the DOT operand is: 


DOT= rEs | 
NO 


For example, if you code: 
LINEDIT TEXT="HI!*", DCT=NO 
the line is displayed as: 


Hi? 


COMP Operand 


Use the COMP operand when you want to display multiple blanks within 
your message text. The format of the COMP oferand is: 


COMP= res | 
NO 


For example, if you code: 
LINEDIT TEXT='"TOTAL 5',COMP=NO 
the line is displayed as: 


TOTAL Die 
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Use the SUB operand to specify the type of substitution to be perforned 
on those portions of the message that contain periods. For each set of 
periods, you must specify the type of substitution and the value to be 
substituted or its address. The format of the SUB operand is: 


SUB= ( HEXj, (reg) ) 
DECl, expression 


are are a 
DECA {, (reg) 


HEX4A (,address 
CHARA |, (reg) 
CHARSA Oe ea 


(reg) (reg) 


Each of the possible substitution pairs is described below, followed by 
discussions of length specification and multiple substitution lists. 


HEX, (reg) 
converts the value in the specified register to graphic hexadecinal 
format and substitutes it in the message text. If you code fewer 
than eight consecutive periods in the message text, then leading 
digits are truncated; leading zeros are not suppressed. 


For example, if register 3 contains the value C0031FC8, then the 
macro instruction: 


LINEDIT TEXT="VALUE = ...',SUB= (HEX, (3) ) 
results in the display: 
VALUE = FC8. 
HEX,expression 
converts the given expression to graphic hexadecimal format and 
Substitutes it in the message text. The expression may be a 
symbolic address or symbol equate; it is evaluated by means of a 


LOAD ADDRESS (LA) instruction. For example, if your program has a 
label BUFF1, the line: 


LINEDIT TEXT="BUFFER IS LOCATED AT ......',SUB= (HEX,BUFF1) 
might result in the display: 
BUFFER IS LOCATED AT O201AC. 


If you code fewer than eight periods in the message text, leading 
' digits are truncated; leading zeros are not suppressed. 


DEC, (reg) 
converts the value in the specified register into graphic decimal 
format and substitutes it in the message text. Leading zeros are 
suppressed. If the number is negative, a leading minus’ sign is 
inserted. For example, if register 3 contains the decimal value 
10,345, then the macro instruction: 


LINEDIT TEXT="REG 3 = ......°', SUB=(DEC, (3)) 
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results in the line: 
REG 3 = 10345. 


DEC, expression 
converts the given expression to graphic decimal format and 
substitutes it in the message text. The expression may be a 
symbolic label in your program or a symbol equate. For example, if 
your program contains the statement: 


VALUE EQU 2003 
then the macro instruction: 

LINEDIT TEXT="VALUE IS ......',SUB= (DEC, VALUE+5) 
results in the display: 

VALUE IS 2008. 


HEXA,address 
converts the fullword at the specified address to graphic 
hexadecimal format and substitutes it in the message text. If you 
code fewer than eight periods in the message text, leading digits 
are truncated; leading zeros are not removed. For example, if you 
code: 


LINEDIT TEXT="HEX VALUE IS .....',SUB=(HEXA,CODE) 


then the last five hexadecimal digits of the fullword at the label 
CODE are sutrstituted into the message text. 


HEXA, (reg) 
converts the fullword at the address indicated in the specified 
register into graphic hexadecimal format and substitutes it in the 
message text. For example, if you code: 


LINEDIT TEXT="REGISTER 5 -> ......',SUB= (HEXA, (5) ) 


then the last six hexadecimal digits cf the fullword whose address 
is in register 5 are substituted in the message text. 


Tf you code fewer than eight digits, leading digits are truncated; 
leading zeros are not suppressed. 


DECA,address 
converts the fullword at the specified address to graphic decimal 
format. Leading zeros are suppressed; if the number is negative, a 
minus sign is inserted. For example, if you code: 


LINEDIT TEXT="COUNT = ......',SUB= (DECA, CCUNT) 


then the fullword at the location COUNT is converted to graphic 
decimal format and substituted in the message text. 


DECA, (reg) 
converts the fullword at the address specified in the indicated 


register into graphic decimal format and substitutes it in the 
message text. For example: 


LINEDIT TEXT="SUM = ....-.-.-..',SUB=(DECA, (3) ) 


causes the value in the fullword whose address is in register 3 to 
be displayed in graphic decimal format. 
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HEX4A,address 
converts the data at the specified address into graphic hexadecimal 
format, and inserts a blank character following every four bytes 
(eight characters of output). The data to be converted does not 
have to be on a fullword boundary. 


When you code periods in the message text for substitution, you 
must code sufficient periods to allow for the blanks. Thus’ to 
display 8 bytes of information (16 hexadecimal digits), you must 
code 17 periods in the message text. 


For example, to display seven Lytes of hexadecimal data beginning 
at the location STOR in your program, you could code: 


LINEDIT TEXT="STOR: ~..2.22cccee22-', SUB= (HEXSYA,STOR) 
This might result in a display: 
STOR: OA23F115 78ACFE 


Note that 15 periods were coded in the message text, to allow for 
the blank following the first four bytes displayed. 


HEX4A, (reg) 
converts the data at the address indicated in the specified 
register into graphic hexadecimal format and inserts a blank 
character following every four bytes displayed (eight characters of 
output). 


When you code the message text for substitution, you must code 
sufficient periods to allow for the blank characters to be 
inserted. 


For example, the line: 
LINEDIT TEXT="EUFFER: wcccccccccccccccccee ' ,SUB= (HEX4A, (6) ) 


results in the display of the first nine bytes at the address in 
register 6, in the format: 


hhhhhhhh hhhhhhbhh hh 


CHARA, address 
substitutes the character data at the specified address into the 
message text. For example: 


LINEDIT TEXT="NAME IS *f....22222-'!'* SU B= (CHARA, NAME) 


causes the 10 characters at location NAME to be substituted into 
the message text. Multiple blanks are removed. 


CHARA, (reg) 
substitutes the character data at the address indicated in the 
specified register into the message text. For example: 


LINEDIT TEXT="CODE IS ....',SUB= (CHARA, (7) ) 


the first four characters at the address indicated in register 7 
are substituted in the message line. 


CHAR8A,address 
substitutes the character data at the specified address into the 
message text, and inserts a [lank character following each eight 
characters of output. 
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When you code the message text, you must code enough periods to 
allow for the blanks that will be substituted. 


This substitution list is convenient for displaying CMS parameter 
lists. For example, to display a fileid in an FSCB, you might code 


SUB= (CHAR8A,OUTFILF+8) 


where OUTFILE is the label onan FSCEB macro. If the fileid for 
this file were TEST OUTPUT A1, then the LINEDIT macro instruction 
would result in the display: 


FILEID IS TEST OUTPUT At. 


In the final edited line, multiple blanks are reduced to a single 
blank. 


CHAR8A, (reg) 
substitutes the character data at the address indicated in the 
specified register and inserts a blank character following each 
eight characters of output. 


When you code the message text, you must include sufficient periods 
to allow for the blanks. For example: 


LINEDIT TEXT='PLIST: SG e:al a erevel ale ae e.aie Ge Wee a eee a aae 6 ares eae 
SUB= (CHARBA, (7) ) 


results in a display of four doublewords of character data, 
beginning at the address indicated in register 7. 


SPECIFYING THE LENGTH FOR LINEDIT MACRO SUBSTITUTION: In all the 
examples shown, the length of the argument being substituted was 
determined by the number of periods in the message text. The number of 
periods indicated the size of the output field, and indirectly 


determined the size of the input data area. 


For hexadecimal and decimal substitutions, the input data is 
truncated on the left. To ensure that a decimal number will never be 
truncated, you can code 10 periods (11 for negative numbers) in the 
message text where it will be substituted. For hexadecimal data, code 
eight periods to ensure that no characters are truncated when a fullword 
is substituted. 


When you are coding substitution lists with the CHARA, CHARS8A, and 
HEX4SA options, however, you can specify the length of the input data 
field. You must code the SUB operand as follows: 

SUB=(type, (address,length) ) 


Both address and length may be specified using register notation. For 
example: 


SUB= (HEX4A, (LOC, (4))) 
shows that the characters at location LOC are substituted into the 
message text; the number of characters is determined by the value 
contained in register 4, but it cannot be larger than the number of 
periods coded in the message text. 


You can use this method in the special case where only one character 
is to be substituted. Since you must always code at least two periods 
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to indicate that substitution is to be performed, you can code _ two 
periods and specify a length of one, as follows: 


LINEDIT TEXT="INVALID MCDE LETTER ..*',SUB= (CHARA, (PLIST+24, 1) ) 


SPECIFYING MULTIPLE SUBSTITUTION LISTS: When you want to make several 
substitutions in the same line, you must enter a_ substitution list for 
each set of periods in the message text. For example: 


LINEDIT TEXT="VALUES ARE ...-- and ......', 
SUB= (DEC, (3) , HEXA,LOC) 


Might generate a line as follows: 
VALUES ARE -45 ANT FFE3C2. 


You should remember that if you are using the standard form of the 
Macro instruction, and you want to perform more than one substitution in 
a single line, the LINEDIT macro will not generate reentrant code. If 
you code RENT=NO on the macro line, then you will not receive the MNOTE 
message indicating that the code is nct reentrant. If you want reentrant 
code, you must use the list and execute forms of the macro instruction. 


IF 


SP Operand 


Use the DISP operand to specify the output disposition of the edited 
line. The format of the DISP orerand is: 


DISP=( TYPE 
NOWE 
PRINT 
SIO 
CPCOMM 
ERRMSG 

where: 

DISP=TYPE 


specifies that the message is to be displayed on the terminal. 
This is the default disposition. 


DISP=NONE 
specifies that no output occurs. This option is useful with the 
BUFFA operand. 


DISP=SIO 
specifies that the message is to be displayed, at the terminal, 
using SIO instead of TYPLIN, which is normally used. This option 
is used by CMS routines in cases where free storage pointers may be 
destroyed. Since lines are not stacked in the console buffer, no 
CONWAIT function is perforned. 


DISP=PRINT 
specifies that the line is to ke printed on the virtual printer. 
The first character of the line is interpreted as a_ carriage 
control character and as such does not appear on the printed 
output. (See the discussion of the PRINTL macro fora list of 
valid ASA control characters.) 
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DI SP=C PCOMM 
specifies that the line is to be passed to CP to be executed as a 
CP command. For example: 


LINEDIT TEXT="'QUERY USERS! ,DOT=NO,DISP=CPCOMM 


results in the CP command line being passed to CP and executed. On 
return, register 15 contains the return code from the CP command 
that was executed. 


DISP=ERRMSG 
specifies that the line is to be checked to see if it qualifies for 
error message editing. If it does, it is displayed as an error 
message rather than as a regular line. 


The standard format of VM/SP error messages is 
XxXxnmmnonns 
where xxxmmm is the name of the module issuing the message, nnn is 
the message number, ands is the severity code. You can code 
whatever you want for the first nine characters of the code when 
you write error messages for your programs, but the tenth character 
must specify one of the following VM/SP message types: 


Code Message Type 


I Information 
W Warning 
E Error 


Then, the line is displayed in accordance with the CP EMSG setting. 
If EMSG is set to ON, then the entire message is displayed; if EMSG 
is set to TEXT, then only the message portion is displayed; if EMSG 
is set to CODE, then only the 10-character code is displayed. 


BUFFA Operand 


Use the BUFFA operand to specify the address of a buffer into which the 
edited message is to be written. The message is copied into the 
indicated buffer, as well as being used as _ specified in the DISP 
operand. The format of the BUFFA oferand is: 


sede gra 
(reg) 


When the text is copied into the buffer, the length of the message 
text is inserted into the first byte of the buffer, and the remainder of 
the text is inserted in subsequent Lytes. 


If you use register notation to indicate the buffer address, the code 


generated will not be reentrant. To suppress the MNOTE that informs you 
that code is not reentrant, use the RENT=NO operand. 
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MF Operand 


Use the MF operand to specify the macro format when you want’ to code 
list and execute forms when you write reentrant programs. The format of 
the MF operand is: 


al Lo 


cent | 


where: 


MF=I (Standard form) 
generates an inline operand list for the LINEDIT macro instruction, 
and calls the routine that displays the message. This is the 
default. It generates reentrant code, except under the following 
circumstances: 


e When you specify more than one substitution list 
e When you use register notation with the TEXTA or BUFFA operands 


MF=L (List forn) 
generates a parameter list to te filled in when the execute form of 
the macro is used. 


The size of the area reserved depends upon the number of 
substitutions to be made, which you can specify with the MAXSUBS 
operand. For example: 


LINEDIT MF=L,MAXSUBS=5 


reserves Space for a parameter list that may hold up to five 
substitution lists. This same list may be used by several LINEDIT 
macro instructions. 


MF=(E,address) (Execute form) 
generates code to fillin the parameter list at the specified 
address, and calls the routine that displays the message text. 


The address specified (either a symbolic address or in register 
notation) indicates the location of the list form of the macro. 
The following example shows how you might use the list and execute 
forms of the LINEDIT macro to write reentrant code: 


WRITETOT LINEDIT TEXT="SUBTOTAL ..... TOTAL ..... iy 
SUB= (DEC, (4) , DEC, (5) ) , MF=(E, LINELIST) 


LINELIST LINEDIT MF=L,MAXSUBS=6 


When the execute form of the LINEDIT macro instruction is used, the 
parameter list for the message is built at label LINELIST, where 
the list form of the macro was coded. 
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MAXSUBS Operand 


Use the MAXSUBS operand when you code the list form (MF=L) form of the 
LINEDIT macro instruction. The format of the MAXSUBS operand is: 


MAXSUBS=number 


where number specifies the maximum number of substitutions that will be 
made when the execute form of the macro is used. 


RENT Operand 


Use the RENT operand when you are going to use the standard form of the 
LINEDIT macro instruction and you do not care whether the code that is 
generated is reentrant. The format of the RENT operand is: 


RENT= {YES 
NO 


When RENT=YES (the default) is in effect, the LINEDIT macro expansion 
issues an MNOTE message indicating that nonreentrant code is being 
generated. This occurs when you use the standard form of the macro 
instruction and you specify one of the following: 


e TEXTA= (reg) 
e BUFFA=(reg) 
e More than one substitution pair 


If you do not care whether the code is reentrant, and you do not wish 
to have the MNOTE appear, code RENT=NO. The RENT=NO coding merely 
suppresses the MNOTE statement; it has no effect on the expansion of the 
LINEDIT macro instruction. 
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PRINTL 


Use the PRINTL macro instruction to write a line to a virtual printer. 
The format of the PRINTL macro instruction is: 


RS RN A A SS a ae 
| [label] | PRINTL | line [,length] [,TRC=] [,ERROR=erraddr ] { 
Oa a ee eee a ee eee 


where: 
label is an optional statement latel. 
line specifies the line to be printed. It may he: 
"linetext' text enclosed in quotation marks. 
lineaddr the symbolic address of the line. 
(reg) a register containing the address of the line. 
length specifies the length of the line to be printed. (See Note 1.) 
It may be: 
(reg) a register containing the length. 
n a self-defining term indicating the length. 
TRC= specifies whether or not the current print line includes a TRC 


(Table Reference Character) byte. The TRC byte indicates 
which 3800 translate takle is selected to print a line. 


NO specifies that there is no TRC byte in the line to be 
printed. NO is the default. 


YES specifies that the line to be printed has a TRC byte as 
the second byte in the line. The value of the TRC byte 
determines which 3800 translate table is selected. If an 
invalid value is found, translate table 0 is selected. 


n specifies a value for fTfRC to indicate which 3800 
translate table should be selected before printing the 
line. The line to be printed does not contain a_ TRC 
byte. If an invalid value is specified, translate table 
0 is selected. 


The value of the TRC byte corresponds to the order in which 
you have loaded WCGMs (via the CHARS keyword on the SETPRT 
command). Valid values for TRC are:0, 1, 2, and 3. 


ERROR=erraddr 
specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 


Usage Notes 


1. The maximum length allowed is 151 characters on a virtual 32117 or 
133 characters on a virtual 1403 or 3203. If you do not specify , 
the length, it defaults to 133 characters, unless ‘linetext' is -) 
specified. In this case, the length is taken from the length of the 
line text. 
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If the virtual printer is a 3800, the line may contain a maximum of 
204 bytes of data. In addition, you can specify both a carriage 
control byte, a TRC byte, cr both, for a total line length of up to 
206 bytes. 


The first character of the line is interpreted as a_ carriage 
control character, which may be either ASA (ANSI) or machine code. 
The valid ASA control characters are: 


Character Hex Code Heaning 

}.) 40 Space 1 line before printing 
0 FO Space 2 lines before printing 
7 60 Space 3 lines before printing 
+ KE Suppress space before printing 
1 F1 Skip to channel 1 

2 F2 Skip to channel 2 

3 F3 Skip to channel 3 

uh FY Skip to channel 4&4 

5 F5 Skip to channel 5 

6 F6 Skip to channel 6 

7 F7 Skip to channel 7 

8 F8 Skip to channel 8 

9 F9 Skip to channel 9 

A C1 Skip to channel 10 

B C2 Skip to channel 11 

C C3 Skip to channel 12 


Hex codes xX'cC1* and X'C3" are used in both machine code and ASA 
code. CMS recognizes these codes as ASA control characters, not as 
Machine control characters. 


If the line does not begin with a valid carriage control character, 
the line is printed with a write command to space one line before 
printing (ASA X'40*). 


If you specify TRC= and the virtual printer is not a 3800, the TRC 
byte is stripped off before the line is printed. If the TRC byte 
is invalid, PRINTL issues the following MNOTE: 


MNOTE 8, INVALID TRC SPECIFICATION! 
Translate table 0 is selected if the TRC byte is invalid. 


When the macro completes, register 15 may contain a2 ora 3, 
indicating that achannel 9 or channel 12 punch was’ sensed, 
respectively. You can use these codes to determine whether the end 
of the page is near (channel 9), or if the end of the page has been 
reached (channel 12). You might want to check for these codes if 
you want to print particular information at the bottom or at the 
end of each page Lteing printed. 


When the channel 9 or channel 12 punch is sensed, the write 
operation terminates after carriage spacing but before writing the 
line. If you want to write the line without additional space, you 
must modify the carriage control character in the buffer to a code 
that writes without spacing (ASA code + or machine code 01). 


You must issue the CP CLOSE command to close the virtual printer 
file. Issue the CLOSE command either from your program (using an 
SVC 202 instruction or a LINEDIT macro instruction) or from the CMS 
environment after your program completes execution. The printer is 
automatically closed when you log off or when you use the CMS PRINT 
command. 
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Error Conditions 
If an error occurs register 15 contains one of the following error 
codes: 


Code Meaning 

1 Line too long 

2 Channel 9 punch sensed (virtual 3203 or 3211 only) 
3 Channel 12 punch sensed (virtual 3203 or 3211 only) 
4 Intervention required 

5 Unknown error 

0 Printer not attached 


PUNCHC 


Use the PUNCHC macro instruction to write a line to a virtual card 
punch. The format of the PUNCHC macro instruction is: 


foo ee ee en ee 7 
| [label] | PUNCHC| line [ , FRROR=erraddr ] [ 
ee a ee es ee | 
where; 

label is an optional statement lakel. 

line specifies the line to be punched. It may be: 


'tlinetext' text enclosed in guotation marks. 
lineaddr the symbolic address of the line. 
(reg) a register containing the address of the line. 


ERROR=erraddr 
specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next Sequential instruction in 
the calling program, as it does if no error occurs. 


Usage Notes 


1. No stacker selecting is allowed. The line length must be 80 
characters. 


2. You must issue the CP CLOSE command to close the virtual punch 
file. Issue the CLOSE command either from your program (using an 
Svc 202 instruction) or from the CMS environment when your progran 
completes execution. The punch is closed automatically when you log 
off or when you use the CMS PUNCH command. 


If an error occurs, register 15 contains one of the following error 


Code Meaning 


2 Unit check 
3 Unknown error 
100 Punch not attached 
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RDCARD 


Use the RDCARD macro instruction to read aline from a virtual card 
reader. The format cf the RDCARD macro instruction is: 


De et ye wT ar ee pen a ee PRC eT eS eae TP SPS ED ee a gee eg Be ae G Te TO ae ete OO Ogee SCT Ce ee ee eS ee Te 
| [label] | RDCARD | buffer[{ ,length]}[ ,ERROR=erraddr ] ; 


a i ii a ea a ds a aati a i a a 


where: 
label 1s an optional statement label. 
buffer specifies the buffer address into which the card is to be 
read. It may be: 
bufaddr the symbolic address of the buffer. 
(reg) a register containing the address of the buffer. 
length specifies the length of card to be read. If omitted, 80 is 
assumed. The length may ke specified in one of two ways: 
n a self-defining term indicating the length. 
(reg) a register containing the length. 


ERROR=erraddr 
specifies the address of an error routine to be given 
control if an error is found. If ERROR= is not coded and an 
error occurs, control returns to the next sequential 
instruction in the calling program, as it does if no error 
occurs. 


1. No stacker selecting is allowed. 


2. When the macro completes, register 0 contains the length of the 
card that was read. 


3. You may not use the RDCARD macro in jobs that run under’ the CMS 
batch machine. 


Error Conditions 


If an error occurs, register 15 contains one of the following error 
codes: 


Code Meaning 

1 End of file 

2 Unit check 

3 Unknown error 

5 Length not equal to requested length 
0 


Device not attached 


Section 7. CMS Macro Instructions 491 


RDTAPE Macro 


RDTAPE 


Use the RDTAPE macro instruction to read a record from the specified 
tape drive. The format of the RDTAPE macro instruction is: 


ne 
| [label] | RDTAPE | bkuffer,length [,device] [,MODE=mnode] | 
l | [,ERROR=erradr ] " 


where: 
label is an optional statement label. 
buffer specifies the kuffer address into which the record is to be 
read. It may be specified in either of two ways: 
lineaddr the symbolic address of the buffer. 
(reg) a register containing the address of the buffer. 
length specifies the length of the largest record to be read. A 
65,535-byte record is the largest record that can be read. It 
may be specified in either cf two ways: 
n a self-defining term indicating the length. 
(reg) a register containing the length. 
device specifies the device from which the line is to be read. If 


omitted, TAP1 (virtual address 181) is assumed. It may be 
specified in either of two ways: 


TAPn indicates the symbolic tape number (TAP1 through 
TAP4) . 
cuu indicates the virtual device address. 


MODE=mode specifies the number of tracks, density, and tape recording 
technigue options. It must be in the following forn: 


({ track ],{[density ],{ trtch }) 
track 7 indicates a 7-track tape (implies density=800 and 
trtch=0). 
9 indicates a 9-track tape (implies density=800). 


density 200, 556, or 800 for a 7-track tape. 
800, 1600, or 6250 for a 9-track tape. 


trtch indicates’ the tape recording technigue for 
7-track tape. One of the following must be 
specified: 
O - odd parity, converter off, translator off. 


oc - odd parity, converter on, translator off. 
OT - odd parity, converter off, translator on. 
E - even parity, converter off, translator off. 
ET - even parity, converter off, translator on. 


ERROR=erraddr 
specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error " ) 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 
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Usage Notes 


Le 


2. 


When the macro completes, register 0 contains the number of bytes 
read. 


You need not specify the Mode option when you are reading froma 
9-track tape and using the default density of the tape drive nor 
when you are reading from a 7-track tape with a density of 800 bpi, 
odd parity, with the data converter and translator off. 


error occurs, register 15 contains one of the following error 


Code Meaning 


Invalid function or rfarameter list 
End of file or end of tape 
Permanent I/O error 

Invalid device address 

Tape not attached 

Incorrect length error 


Om lbWh — 


RDTERM 


Use the RDTERM macro instruction to read a line from the terminal into 
an I/O buffer. The format of the RDTERM macro instruction is: 


Cy re a ae ee ee ee ee ST ge a ae ge ee ee YL a Fe ee Te pe eed 


[label] 


RDTERM tuffer[ , EDIT=ccde ][ ,LENGTH=length ][ ,PRBUFF=addr ] 


: 
[ ,PRLGTH=length ]| ,ATTREST= 12s \ 
i NO }| 
L J 


where: 
label is an optional statement latel. 
buffer specifies the address of a Ltuffer into which the line is to be 


read. The tE;uffer is assumed to be 130 bytes long, unless 
EDIT=PHYS is specified. The address may be specified as: 


lineaddr the symbclic address of the buffer. 
(reg) a register containing the address of the buffer. 


EDIT=code specifies the type of editing, if any, to be performed on the 


input line. 


NO indicates that a logical line is to be read and no 
editing is to be done. 


PAD requests that tke input line be padded with blanks 
to the length srecified. 


UPCASE requests that the line be translated to uppercase. 
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YES indicates both padding and translation to uppercase. 
YES is the default. 


PHYS indicates that a physical line is to be read. When 
PHYS is specified, the LENGTH and ATTREST=NO 
operands may also be entered. This option causes 
the input line to be translated using the user 
translation table. 


LENGTH=length 


specifies the length of the buffer. If not specified, 130 is 
assumed. The maximum length is 2030 bytes. The length may be 
Specified only if EDIT=PHYS (see Usage Note 2). It may be 
specified in either of twce forms: 


n a self-defining term indicating the length of the 
tuffer 
(reg) a register containing the length of the buffer. 


PRBUFF=addr (reg) 


Specifies the address of a buffer in which the prompt data 
resides. The length of the prompt data to be written is 
specified by the PRLGTH parameter. If the PRLGTH parameter is 
specified, but the PRBUFF parameter is not, the prompt 
information is assumed to reside in the read buffer. The 
PRBUFF address can be specified as follows: 


addr the symbclic address of the buffer. 
(reg) a register containing the length of the buffer. 


PRLGTH=length 


Specifies the length of the prompt information to be written 
prior to the read. The prompt information is written with no 
Carriage return. The prompt information is written from the 
user's read data buffer cr from the buffer specified by the 
PRBUFF parameter. The length can be specified in either of 
two forms: 


n a self-defining term indicating the length of the 
buffer 
(reg) a register containing the length of the buffer. 


ATTREST=YES | NO 


specifies whether an attention interruption during a_ read 
should result ina restart of the read operation. (See Usage 
Note 2.) 


Usage Notes 


1. 


2a 


WOW 


When the macro completes, register 0 contains the number of 
characters read. 


You can use the ATTREST=NO and LENGTH operands only when you are 
reading physical lines (EDIT=PHYS). When ATTREST=NO, an attention 
interruption during a read operation signals the end of the line 
and does not result in a restart of the read. These operands are 
used primarily in writing VS APL programs. 


The PRBUFF and PRLGTH operands are intended for use with TTY type 
devices. 


If the prompt parameters are used with EDIT=PHYS, the read buffer 


may not be used for the prompt data because the read buffer is 
cleared prior to the execution of the function. 
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Error Conditions 


When an error occurs, register 15 contains one of the following error 
codes: 


Invalid parameter 
Read was terminated by an attention signal (possible only when 
ATTREST=NO) 


Code Meaning 
2 
4 


REGEQU 


Use the REGEQU macro instruction to generate a list of EQU (equate) 
statements to assign symbolic names for the general, floating-point, and 
extended control registers. The format of the REGEQU macro instruction 
is: 


—_——— ne eee 
| | REGEQU | | 


Usage Note 


The REGEQU macro instruction causes the following equate statements to 
be generated: 


General Registers Extended Control Registers 
RO EQU 0 CO EQU 0 
R1 EQU 1 C1 EQU 1 
R2 EQU 2 C2 EQU 2 
R3 EQU 5 C3 EQU 3 
R4Y EQU uy C4 EQU 4 
R5 FOU 5 CS EQU 5 
R6 EQU 6 C6 EQU 6 
R7 EQU 7 C7 EQU 7 
R8 EQU 8 C8 EQU 8 
RO EQU 9 cg EQU 9 
R10 EQU 10 C10 EQU 10 
R11 EQU 11 C11 EQU 11 
R12 EQU 12 C12 EQU 12 
R13 EQU 13 C13 EQU 13 
R14 EQU 14 c14 EQU 14 
R15 EQU 15 C15 EQU 15 
Floating-Point Registers 

FO EQU 0 

F2 EQU 2 

FQ EQU 4 

F6 EQU 6 
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TAPECTL 


Use the TAPECTL macro instruction to position the specified tape Jd 
according to the specified function code. The format of the TAPECTL 
Macro instruction is: 


Be pe ge ek ek Ge EE PEI ete NETO es Ws of ape Ee ete Pea] oo any eee gig ee cs Seeger ee et aes ee geen gl 
| [label] |] TAPECTL | function [,device][{ ,MODE=mode ][ ,ERROR=erraddr ] [ 
Ma ee ee eee ee eee 


label is an optional statement latel. 


function specifies the control function to be performed. It must be 
one of the following codes: 


Code Function 
REW Rewind the tape 
RUN Rewind and unload the tape 
ERG Erase a gap 
BSR Backspace one record 
BSF Backspace one file 
FSR Forward-Space one record 
FSF Forward-space one file 
WIM Write a tape mark 
device Specifies the tafe on which the control operation is_ to be 
performed. If omitted, TAP1 (virtual address 181) is assumed. 
It may be: 
TAPn indicates the symbolic tape number (TAP1 through 
TAP). 
cuu indicates the virtual device address. 


MODE=mode specifies the numker of tracks, density, and tape recording 
technique options. It must be in the following form: 


({ track ],[ density ],[trtch }) 


track 7 indicates a 7-track tape (implies density=800 and 
trtch=0). 
9 indicates a 9-track tape (implies density=800). 


density 200, 556, or 800 for a 7-track tape. 
800, 1600, or 6250 for a 9-track tape. 


trtch indicates the tape recording technigue for 
J-track tape. One of the following must _ be 
specified: 


OQ - odd parity, converter off, translator off. 
OC - odd parity, converter on, translator off. 
OT - odd parity, converter off, translator on. 
E - even parity, converter off, translator off. 
ET - even parity, converter off, translator on. 


ERROR=erraddr 
specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 
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Usage Note 
You need not specify the MODE option when you are manipulating a 9-track 
tape and you are using the default density for the tape drive, nor when 


you are writing a 7-track tape with a density of 800 bpi, odd parity, 
with data converter and translator off. 


Error Conditions 


If an error occurs, register 15 contains one of the following error 
codes: 


Code Meaning 


1 Invalid function or parameter list. 
2 End of file or end of tape 
3 Permanent I/0 error 
4 Invalid device id 
5 Tape is not attached 
6 Tape is file-protected 
TAPESL 


The TAPESL macro processes IBM standard HDR1 and EOF1 labels without 
using DOS or OS OPEN and CLOSE macros. ThiS macro is used with RDTAPE, 
WRTAPE, and TAPECTL. TAPESI processes only HDR1 and EOF1 labels. It 
does not process other labels such as standard user labels or HDR2 
labels. It does not perform any functions of opening a tape file other 
than label checking or writing. The same macro is used both to check 
and to write tape labels. A LABELDEF command must be supplied 
separately to use the macro. The tape must be positioned correctly (at 
the label to he checked or at the place where label is to be written) 
before issuing the macro. TAPECTL may be used to position the tape. 
TAPESL reads or writes only one tape record unless SPACE=YES is 
specified. The format of the TAPESL macro is: 


[label] | TAPESL function[ , device ], LABID=labeldefid[ , MODE=node ] { 
[, BLKCNT=blkcnt ][ ,ERROR=erraddr ] | 
r 1¢ 1 | 
le SPACE=/zz5} |, T= {zEs\t | 
i NO NO fy | 
. | 


I 
at 


where: 
function is one of the following: 
HIN checks input HDR1 label. 
HOUT writes HDR1 label. 
EIN checks input EOF1 label. 
EOUT writes output EOF1 label. 
EVOUT writes output EOV1 label. 
device is one of the following: 
TAPn n=1-4. If omitted, 181 is assuned. 
cuu 181-184 are the only values allowed. 
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MODE=mode specifies the number of tracks, density, and tape recording 


technigue options. It must be in this forn: 
({track ],[ density ],{[trtch }) 


track 7 indicates a 7-track tape (implies density=800 and 
trtch=0). 
9 indicates a 9-track tape (implies density=800). 


density 200, 556, or 800 for a 7-track tape. 
800, 1600, or 6250 for a 9-track tape. 


trtch indicates’ the tape recording technique for 
7-track tape. One of these must be specified: 


O - odd parity, converter off, translator off. 
oc - odd parity, converter on, translator off. 
OT - odd parity, converter off, translator on. 
E - even parity, converter off, translator off. 
ET - even parity, converter off, translator on. 


LABID=labeldefid 


specifies the 1- to 8-character name on the LABELDEF command 
to be used for the file. (A separate LABEFLDEF statement must 
be specified for the file before the program containing TAPESL 
is executed.) 


BLKCNT=blkcnt 


specifies the block count to be inserted in an EOF1 or EOV1 
label on output or used to check against on input. This field 
is only used for functions EOUT, EIN, or EVOUT. If not 
specified, the cutput block count is set to 0. This field may 
also be spe@eified as a register number enclosed within 
parentheses when a general register contains the block count. 


ERROR=erraddr 


ee 


TM= 
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YES 


NO 


specifies the address of an error routine to be given control 
if an error of any kind occurs during label processing. If 
ERROR= is not coded and an error occurs, control is returned 
to the next sequential instruction in the calling program. If 
you request the EIN function and a block count error is 
detected, control is transferred to your error routine if you 
Specify an ERROR= parameter that contains an address different 
from the next sequential instruction. If no error return is 
specified or the EFRROR= address is the same as the normal 
return, a block count error causes message 425R to be issued. 


may be specified for functions HIN and EIN. If YES is 
Specified, the tape is spaced, after processing, beyond the 
tapemark at the end of the label record. If NO is specified, 
the tape is not moved after the label has been processed. YES 
is the default. 


may be specified for functions HOUT, EOUT, and EVOUT. If YES 
is specified, a single tapemark is written after a HDR1 or 
EOV1 label. Two tapemarks are written after an EOF1 label. 
If NO is specified, no tapemarks are written. YES is the 
default. 
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Usage Notes: 


1. The input functions HIN and FIN read a tape label and check to see 
if it is the type specified. They also check any fields in the 
tape label that have been specified explicitly (no defaulted) in 
the LABELDEF statement (indicated by LABID). Any discrepancies 
between the fields in the LABELDEF statement and the fields on the 
tape label cause an error message to he issued and an error return 
to be made. 


2. The output functions HCUT, EOUT, and EVOUT write a tape label of 
the requested type on the specified tare. The values of fields 
within the labels are those specified or defaulted to in the 
LABELDEF command. See the description of the LABELDEF command in 
this publication for informaticn about the default fields. 


3. For a more complete discussion of tape label processing, see the 
section "CMS Tape Laktel Processing" in the VM/SP CMS User's Guide. 


Error Conditions 


When an error occurs, register 15 contains one of the following error 
codes: 


Code Meaning 
24 Invalid device tyre specified. 
28 LABELDEF cannot be found. 
32 Error in checking tape label or block count error. 
36 Output tape is file-protected. 
40 End of file or end of tape occurred. 
100 Tape I/O error occurred. 
WAITD 


Use the WAITD macro instruction to cause the program to wait until the 
next interruption occurs on the specified device. The format of the 
WAITD macro instruction is: 


a eae eT Oe Ge eae TON NE age Seg he ee ET og PE NE SRS SS Se ey Rs eR a eS pl 
| [label] | WAITD | device...[,devicen] [ ,ERROR=erraddr ] | 
Or a a i a a a a a 


label is an optional statement label. 


devicen specifies the device(s) to be waited for. One of the 
following may be specified: 


Symm indicates the symbolic device name and number, where: 


sym is CON, DSK, PRI, PUN, RDR, or TAP. 
n indicates a device number. 


user is a four-character symbolic name specified a HNDINT 
macro issued for the same device. 


ERROR=erraddr 
specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns tc the next seguential instruction in 
the calling program, as it does if no error occurs. 
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WAITD, WAITT, Macros 


Usage Notes 


1. Use the WAITD macro instruction to ensure completion of an I/0 
operation. If an interruption has been received and not processed 
from a device specified in the WAITD macro instruction, the 
interruption is processed before program execution continues. 


2. When the interruption has been completely processed, control is 
returned to the caller with the name of the interrupting device in 
register 1. 


3. If an HNDINT macro instruction issued for the same device specified 
ASAP and an interruption has already been processed for the device, 
the wait condition is satisfied. 


4%. If an HNDINT macro instruction issued for the same device specified 
WAIT and an interruption for the device has been received, the 
interruption handling routine is given control. 


5. The interruption routine determines if an interruption is 
considered processed or if more interruptions are necessary to 
satisfy the wait condition. For additional information see the 
discussion of the HNDINTI macro instruction. 


When an error is detected, register 15 contains a 1 to indicate that an 
invalid device number was specified. 


WAITT 


Use the WAITT macro instruction to cause the program to wait until all 
of the pending terminal I/C is complete. The format of the WAITT macro 
instruction is: 


Fe ee eg Fe NF pe gee | le Re a ee EN ep ee a ga Gere eee eee See Te eee me aE 
| {label] | WAITT | | 


label is an optional statement latel. Usage Note 
The WAITT macro instruction synchronizes.input and output to the 
terminal; it ensures that the console stack is cleared before the 
program continues execution. Also, you can ensure that a read or write 
operation is finished before you modify an I/O kuffer. 
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WRTAPE Macro 


WRTAPE 


Use the WRTAPE macro instruction to write a record on the specified tape 
drive. The format of the WRTAPE macro instruction is: 


Wg ee ee ee gy ee ge eg ee ee eT ee ee ee gar ag Fhe eT Oy ee ne 
[| [label] | WRIAPE | buffer,length [,device] [ , MODE=node ] | 
| [,ERROR=erraddar ] | 


where: 
label is an optional statement latel. 
buffer specifies the address of the record to be written. It may be: 
lineaddr the symbolic address of the line. 
(reg) a register containing the address of the tine. 
length specifies the length of the line to be written. It may be 
specified in either of two ways: 
n a self-defining term indicating the length. 
(reg) a register containing the length. 
device specifies the device to which the record is to be written. If 


omitted, TAP1 (virtual address 181) is assumed. It may be: 


TAPn indicates the symbolic tape number (TAP1 through 
TAP4). 
cuu indicates the virtual device address. 


MODE=mode specifies the number of tracks, density, and tape recording 
technique. It must be in the following forn: 


({track],{ density ],[ trtch }) 
track 7 indicates a 7-track tape (implies density=800 and 
trtch=0). 
9 indicates a 9-track tare (implies density=800). 


density 200, S56, or 800 for a 7-track tape 
800, 1600, or 6250 for a 9-track tape. 


trtch indicates the tape recording technique for 
7-track tape. One of the following must be 
specified: 
O - odd parity, converter off, translator off. 


OC - odd parity, converter on, translator off. 
OT - odd parity, converter off, translator on. 
E - even parity, converter off, translator off. 
ET - even parity, converter off, translator on. 


ERROR=erraddr 
specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 
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WRTAPE, WRTERM Macros 


Usage Note 


You need not specify the MODE option when you are writing to a 9-track 
tape and want to use the default density, nor when you are writing to a 
7-~track tape with a density of 800 bri, odd parity, with data converter 
and translator off. 


Frror Conditions 


If an error occurs, register 15 contains one of the following error 
codes: 


Code Meaning 
1 Invalid function or parameter list 
2 End of file or end of tape 
3 Permanent I/O Error 
4 Invalid device identification 
5 Tape not attached 
6 Tape is file-protected 


WRTERM 


Use the WRTERM macro instruction to display a line at the terminal. The 
format of the WRTERM macro instruction is: 


eg er ee eS gg et Cg Sep Toes oe en Saab igs a ee Cap GO eT ie ee ye ee peng ee eo eg al 
| [label] | WRTERM | line [,length] [,EDIT=code ]} [,COLOR=color] ; 
ee en ee a ee a eee ee 


label is an optional statement lakel. 


line Specifies the line to be displayed. It may be one of three 
forms: 


"‘linetext' the actual text line enclosed in quotation marks. 


lineaddr the label on the statement containing the line. 
(reg) a register containing the address of the line. 
length specifies the length of the line. If the line is specified 


within quotation marks in the macro instruction, the length 
operand may be omitted. The length may be specified in either 
of two ways: 


n a self-defining term indicating the length. 
(reg) a register containing the length. 


ENDIT=code specifies whether the line is to be edited: 
YES indicates that trailing blanks are to ke removed anda 
carriage return added to the end of the line. YES is the 
default value. 


NO indicates that trailing blanks are not to be removed and 
no carriage return is to be added. 


LONG indicates the line may exceed 130 bytes. No editing is 
performed. 
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WRTERM Macro 


COLOR=color 


indicates the color in which the line is to be typed, if the 
typewriter terminal has a two-color ribbon: 


B indicates that the line is to be typed in black. This is 
the default. 
R indicates that the line is to be typed in red. 


Usage Notes 


Ne 


2 


The maximum line length is 130 characters for a black line and 126 
Characters for a red line. 


If EDIT=LONG, COLOR must be specified as "B". In this case, you may 
write as many as 1760 bytes with a single WRTERM macro instruction. 
You are responsible for embedding the proper terminal control 
characters in the data. (This operand is for use primarily with VS 
APL programs.) 


You may want to use the WAITT macro instruction to ensure that 
terminal I/O is complete before continuing program execution. 


When EDIT =NO is used, the same output to graphics devices and to 


line terminal devices may appear inconsistent because of 
differences in device characteristics. 
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HELP Format Words 


Section 8. HELP Format Words 


This section describes the formats, operands, and defaults of the HELP 
facility format words. In each of the format word descriptions, the 
default values are those that are implied when you enter a format word 
with no operands or parameters. For example, the default operand of the 
-FO (FORMAT MODE) format word is ton'. Therefore, the format lines 


-fo 
-f0 on 


are equivalent, and in the format tox of the .FO format word the ‘on' 
operand is underscored. 


HELP format words are used only in HELP description files when the user 


wants HELP to do output formatting when the file is processed. Figure 
32 1S a summary of the HELP facility format words. 
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HFLP Format Words 


a aaa Ra a a a a Na a cr | 


| Format | Operand | | | Default | 
| word | Format [ Function | Break | Value | 
[ SS | 
|-BX (BOX) | V1 V2 ...Vn]| Draws horizontal and | Yes |Draws a [ 
| | OFF | vertical lines around [ [horizontal | 
; | | subsequent output text in | | line. i 
| | | tlank columns. | | [ 
| | | l | | 
|.CM | Comments | Places commentsS ina | No [ [ 
| (COMMENT) | | file for future reference. | | [ 
| | | | | 
[Cc | n ON/OFF | Allows conditional | No [ [ 
| eoniie | | inclusion of input in | | 
{ TIONAL |] | the formatted output. | [ | 
| SECTION) | | [ ] | 
[ | | | | | 
]}-FO | ON/OFF | Causes concatenation of | Yes |On ( 
| (FORMAT | | input lines, and left and | | | 
; -MODE) | | right-justification of | | | 
I | | output. ; | [ 
| i | | | 
}~-IL (IN- | nitn[-n | Indents only the next | Yes |0 | 
[DENT LINE) | | line the specified | [ 
[ | | number of spaces. | | [ 
| | H I | | 
}-IN (IN- | nj+#nj|-n | Specifies the number | Yes |0 [ 
| DENT) | | of spaces subsequent | [ | 
| | | text is to be indented. | | | 
I | | ; [ | 
|.OF (OFF- | n[+n|-n | Provides a technique | Yes |0 i 
| SET) | | for indenting all but | | | 
{ ] | the first line of a | | | 
; | | section. [ [ | 
[ | | { | | 
].-SP | n | Specifies the number | Yes |1 | 
| (SPACE) | | of blank lines to be { | [ 
I [ | inserted refore the { | [ 
; | } next output line. | | | 
| | | | | | 
|}-TR(TRANS-| s t | Specifies the final {| No | | 
| LATE) | | output representation. | | | 
[ | } of any infut character. | | i 
| | | | { | 
a aa a a 


Figure 32. HELP Format Word Summary 


506 IBM VM/SP CMS Command and Macro Reference 


HELP Format Words - .BX 


.BX (Box) 


The BOX format word defines and initializes a horizontal rule for output 
and defines vertical rules for subseguent output lines. 


The format of the .BX format word is: 


De Ge Ge ag Se Og ee a RS Se a Ty pe Os OE a Ne eg ON NG Re eng eS 

| I r 1 | 

| . BX | Jvl v2 [...[vn]]] [ 

| | [OFF | | 

| I = . | 

_ oe ee ne EO ee Te ee ne ee ee | 

where: 

vl-vn are the positions at which you want to plae vertical rules in 
output text. This format of the format word initializes the 
box and draws a horizontal line with vertical descenders at 
the columns indicated. Subsequently entering the .BX format 
word with no operands causes HELP to print a horizontal line 
With vertical bars at the columns indicated. 

off causes HELP to finish drawing the box by printing a horizontal 


line with vertical ascenders at the columns specified ina 
previous .PX format word. 


Usage Notes 


1. 


The .BX format word describes an overlay structure for subsequent 
text that is processed by HELP. After the '.BX v1v2...' line is 
processed, HELP continues processing output lines as usual. 
However, before a line is frinted, HELP places vertical bars in the 
columns indicated by v1, v2, and so on, unless a column is already 
occupied by a data character. In this case, HELP does not place a 
vertical bar in the column. 


The .BX control word causes a break in the text. 


The terminal output characters for boxes are formed with dashes 
(-), vertical bars (|), and plus signs (+). 


You can specify a .BX format word with different columns while a 
box is being drawn. When this happens, HELP puts in vertical 
ascenders for all the old columns and vertical descenders for all 
the new columns. The vertical rules then appear in all subsequent 
output lines in the new columns designated. 


The column specification for the .BX format word uses a different 
rule than is used elsewhere in HELP. In some control words the 
numbers in the format word represent not columns but displacements. 
For example the HELP format word .IN 5 means that a blank character 
Should be expanded to enough tlanks to fill up through column 5; 
the next word starts in column 6. In the .~.BX control word, .BX 5 
means to put vertical rules in column 5. Thus, you can use the 
Same numbers for a .IN control word as for a .BX control word, and 
the vertical bar will appear in the column immediately preceding 
the first word on that line. 
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HFLP Format Words - .BX 


Example 
Consider the HELP file called ‘MARYHALA* that looks like this: 


-fo off 

e-bx 1 43 

ein 5 

Mary had a little lank, 

Whose fleece was white as Snow, 
And everywhere that Mary went, 
The lamb was sure to go. 

-bx off 


This file, when processed Ly HELP, creates the following output: 


5 
Mary had a little lamb, 


[ 
| Whose fleece was white as snow, 
| And everywhere that Mary went, 
{ The lamb was sure to go. 

pas we ee ee eed 


as oe oe os ol 
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HELP Format Words - .CM 
.CM (Comment) 


Use the COMMENT format word to place comments within a HELP file. 


The format of the .CM fcrmat word is: 


CM | comments | 


where: 
comments may be anything; this input line is not used in formatting the 
output. 
Usage Notes 
1. The .CM format word enables you to store comments in the HELP files 
for future reference. The comments can be seen only by editing the 


HELP file. 


2. You can use comments to store unique identifications to be used to 
locate a specific region of the file during editing. 


Example 
-CM Remember to change the date. 


The line above is seen only when editing the HELP file, and it reminds 
you to change the date used in the text. 
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HELP Format Words - .CS 


.CS (Conditional Section) 


The CONDITIONAL SECTION format word identifies to HELP the section of 
the input file that is to be displayed first based on the specified HELP 
command option. 


The format of the .CS format word is: 


® 

@) 
wn 
i=] 
' om | 
© 
=z 
| 


{[ OFF ]} 
a tainted 
where: 
n specifies the conditional section code number from 1 to 3. 


on marks the beginning of conditional section n. 


off marks the end of conditional section n. (For HELP files, it is not 
necessary to have control words '.cs n off'. 


Usage Notes 


1. The .CS format word enables you to identify the specific sections 
of the input file that are directly associated with the HELP 
facility command ‘options’. 


You can then specify which section of the HELP file is to be 
displayed first by using the HELP command options DESC, FORM and 
PARK. 


If you choose to implement any HELP description files using the 
ALL, PARM, FORM, and DESC options, the format word .CS is reguired 
in the file. You must use the following forn: 


Top of file 
-CS 1 on 

(Text for DESC option) 
-CS 1 off 
-CS 2 on 

(Text for FORM option) 
CS 2 off 
-CS 3 on 

(Text for PARM option) 
-CS 3 off 
End of file 
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HELP Format Words - .FO 


.FO (Format Mode) 


Use the FORMAT MODE format word to cancel or restore concatenation of 
input lines and right-justification of output lines. 


The format of the .FO format word is: 


where: 

ON restores default HELP formatting, including both justification 
and concatenation of lines. If you use the .FO format word 
with no operands, CN is assumed. 

Off cancels concatenation of input lines and justification of 


output lines. Subsequent text is printed ‘as is'. 


Usage Notes 


1. When format mode is in effect, lines are formed by shifting words 
to or from the next line (concatenation) and padding with extra 
blanks to produce an aligned right margin (justification). 


2. This format word acts as a break. 


3. When format mode is in effect, a line without any blanks’ that 
exceeds the current line length is extended into the right margin. 
If a line is processed so that only one word fits on the line, the 
word is left-justified. 


4, If no formatting is to be done by HELP, HELP description files must 
contain a '.fo off' format word as the first line of the file. 


Justification and concatenation are 

completed for 

the preceding line or lines, but the following 
lines are 

typed exactly as they appear in the file. 


26 «FO 
Justification and formatting are resumed with the next input line. 


Output from this point on in the file is padded to produce an aligned 
right margin on the output page. 
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HELP Format Words - .IL 


.IL (Indent Line) 


Use the INDENT LINE format word to indent the next line only a specified 
number of characters. 


The format of the .IL format word is: 


oom wae amet oe ol 


n Specifies the number of character spaces to shift the next 
line from the current Margin. +n specifies that text is 
shifted to the right, and -n shifts text to the left. 


Usage Notes 


1. The .IL format word provides a way to indent the next output line. 
The line is shifted to the right or the left of the current margin 
(which includes any indent or offset values in effect). 


2. This format word acts as a break. 

3. The .IL format word is useful for beginning new paragraphs. 

4. When successive .IL format words are encountered without 
intervening text, or when you specify positive or negative 
increments for .IL format words entered without intervening text, 
the indent amount is modified to reflect the last .IL encountered; 
that is, the increments are added together. Thus the lines: 


rs fb rit 
eil +6 


result in the next line being indented 10 spaces. 
5. When you use the .IL format word with a negative value (undenting) , 


an error message is generated if the resulting amount would cause a 
shift to the left of character position one. 
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HELP Format Words - .IN 


.IN (Indent) 


Use the INDENT format word to change the left margin displacement of 
HELP output. 


The format of the .IN format word is: 


specifies the number of spaces to be indented. If omitted, 0 
is assumed, and indentation reverts to the left margin. If 
you use +h or -n, the current left margin increases or 
decreases by the amount specified. 


Usage Notes 


We 


The .IN format word resets the current left margin. This 
indentation remains in effect for all following lines until another 
-IN format word is encountered. ‘'.IN 0" cancels the indentation, 
and output continues at the original left margin setting. 


The value of n represents the number of blank spaces left before 
text margins. Thus, '.in 5* sets the left margin at column 6, 
leaving 5 blank spaces at the left. 

This format word acts as a break. 

The .IN format word cancels any .OF (OFFSET) setting. The .OF 0 


request cancels the current offset, but leaves the left margin 
specified by the .IN format word unchanged. 
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HELP Format Words - .OF 

.OF (Offset) 

Use the OFFSET format word to indent all but the first line of a block 
of text. 


The format of the .OF format word is: 


- OF 


specifies the number of spaces to he indented after the next 
line is formatted. If omitted, 0 is assumed, and indentation 
reverts to the original margin setting. If you use +n or —n, 
the current offset value increases or decreases the specified 
amount, and a new offset is started. 


Usage Notes 


1s 


The .OF format word does not take effect until after the next line 
is formatted. The indentation remains in effect until a e.IN 
(INDENT) format word or another OFFSET control word is encountered. 


You can use the .OF fcrmat word within a section that is also 
indented with the .IN format word. Note that .IN settings take 
precedence over .OF, however, and any .IN request causesS a previous 
offset to be cleared. 


If you want to start a new section with the same offset as the 
previous section, you need only repeat the .OF n request. 


2. This format word acts as a break. 
3. You can use the .IL (INDENT LINE) format word to shift only the 
next line to the left or right of the current margin. 
Example 
1. Starting an offset: 
-of 10 
The line immediately following the .OF format word is printed 
at the current left margin. All lines thereafter (until the 
next indent or offset request) are indented ten spaces fron 
the current margin setting. These two examples were processed 
with OFFSET control words in the positions shown. 
2. Ending an offset: 


-of 


The effect of any previous .OF reguest is canceled, and all output after 
the next line continues at the current left margin setting. 
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HELP Format Words - .SP 


.SP (Space Lines) 


Use the SPACE LINES format word when you want blank lines to appear 
retween text lines of output. 


The format of the .SP format word is: 


n Specifies the number of blank lines to be inserted in the 
output. If omitted, 1 is assumed. 
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HELP Format Words - .TR 
.TR (Translate Character) 


The TRANSLATE CHARACTER format word allows you to specify the output 
representation of each character in the source text. For example, you 
could specify that all exclamation points in the file appear as blanks 
in the output. 


The format of the .TR format word is: 


| 
| -TR | [st] | 
| | | 
| are ae a a ee Se J 
where: 
s is a source character under consideration. It may be a single 


character or a two-character hexadecimal code. 


cr 


is the intended output representation of the source character. 
It may be a single character or a two-character hexadecinal 
code. 


Usage Notes 


1. After formatting of an input source line has been completed and 
immediately before actual output, each character of the output line 
nay be translated to a different output code. 


2. Since format words are only processed internally, they are never 
translated in the file. 


3. Translate Character specifications remain in effect until 
explicitly respecified. 


4. A .TR format word with no operands causes the translation table to 
be reinitialized and all freviously specified translations to be 
reset. 


5. The .TR format word does not cause a break. If you have a section 
of text that has translation characters in effect, followed bya 
-TR to reset the translations, the last line of the text may not 
yet have been printed. In this case, that last line is not 
translated. 


Example 
-tr 40 ? 


This causes all blanks in the file to be typed as question marks (7?) on 
output. 
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Appendixes 


The following appendixes are provided for your convenience: 


e Appendix A: Reserved Filetype Defaults 
e Appendix B: VSE/VSAM Functions Not Supported in CMS 


e Appendix C: OS/VS Access Method Services and VSAM Functions 
Not Supported in CMS 
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Appendix A: Reserved Filetype Defaults 


se, a ee ee ee eg ee ee ee a ee ae a eg ee a Te fo te a oe ee ge oe ee I a ee 
|Filetype|RECFM|LRECL|ZONE| TRUNC|VERIFY|SERIAL| TABS |Dsage | 
|-_———___-_--_--—__-—_---—_-_—_-_-------—_—__-—_.-—---» - OO O-OvowO)ROO een ne f 
{default | F | 80 |1 ¥*]| * 1 * | OFF |1,6,11,16,21,26,31,36,|Al1 other filetypes | 
I | | l | I 1 41,46,51,61,71,81,91, | I 
| { I | | | [| 101,111,121,131 | | 
| ee ee 
|AMSERV | F | 80 [2 72 72 172 | OFF |2,6,11,16,21,26,31,36,|Input Control statements for | 
| | | | | | | 41,46,51,61,71,80 | Access Method Services | 
| | 
[ASSEMBLE| F | 80 |171] 71 172 | ON 11,10, 16,31, 36,41,46, |Assembler language source | 
| | | | | | | 69,72,80 | statements. | 
{1ASM3705 | F | 80 41 71] 71 72 | ON 11,10,16,31,36,41,46, |Macro instruction for 3705 | 
| | | | | | | 69,72,80 | Assembler | 
| | 
| BASIC | F | 80 |7 *| * 1 * | L/L |[7,10,15,20, 25,30, 80 |BASIC source statements; and | 
| BASDATA | | | | | | | execution—tine files. | 
| I 
|COBOL i F J 80 {1 72| 72 172 | ON 11,8,12,20,28,36,44,68,|COBOL source statenents. | 
| | | | | | 1 72,80 | | 
|_———_————————-__—_——_.._._.--"_-_-‘---—_—_- - rr ee eel 
J|DIRECT | F | 80 {1 72| 72 172 | ON 11,6,11, 16,21, 26,31,36,|VM/S? user directory entries | 
| | | | | \ | 41,46,51,61,71 | I 
| -— —— = 
| EXEC | Vv | 80 |1 *| * 1 * | OFF [1,6,11, 16,21,26,31,36,|EXEC procedures. | 
I | | | | l | 41,46,51,61,71 I | 
i | 
| FREEFORT| V | 81 |9 #*| * 1 * | L/L 19,15, 18,23, 28,33,38, | FREEFORM FORTRAN source | 
| | | | | | | 81 | statements. | 
I | 
|FORTRAN | F | 80 |1 72] 72 172 | ON 11,7,10, 15,20,25,30,80 |FORTRAN source statenents. | 
| —| 
{LISTING | V | 121 [1 #¥]| * 1 * | OFF [|1,6,11, 16,21,26,31,36,|Command, program, and | 
| | | | | | | 41,46,51,61,71,81,91,| compiler listings. | 
I | | | { i 1 101,111,121,131 | I 
| | 
| MACRO | F | 80 {1 71] 71 72 | ON 11,10, 16,31,36,41,46, |Macro definitions. | 
I l | | | | | 69,72,80 | I 
| { 
| MEMO | F | 80 {1 #*| * 1 * | OFF 11,6,11, 16,21,26, 31,36, | Documentation. (Default CASE| 
| | | | | | | 41,46,51,61,71 | value is M.) | 
| SS I 
| PLI | F | 80 4{2 72] 72 172 | ON 12,4,7,10,13,16,19,22, |PL/I Source statements. | 
|PLIOPT | | | | | | 25,31,37,43,49,55,79, | | 
| | | | I I | 80 l | 
i ef 
|SCRIPT | V 4 132 [1 ¥] * 1 * | OFF | {IMAGE setting is |SCRIPT text processor input. | 
| | | | | | | CANON.) | {Default CASE setting is 4A.) | 
I TTT ——O0° 0 ee { 
JOPDATE | F | 80 ]|171] 71 72 | ON 11,10, 16,31,36,41,46, |Update files for assembler | 
| | | | | | | 69,72,80 | language programs. | 
{ —| 
{OPDTxxxx| F | 80 |1 71] +71 72 | ON 11,10, 16,31,36,41,46, |Update files for assembler | 
l | I | | | | 69,72,80 | language programs. I 
|—-—-___—__ - __————__———eeerrnr re mcr | 
|VSBASIC | F | 80 |7 ¥*¥| * 1 * | LYL [7,10,15,20,25,30,80 I1¥S BASIC source statements. | 
| rr 
|VSBDATA | Vv | 132 |1 #*¥| * 1 * | OFF |1,6,11, 16,21,26,31,36,|V¥VS BASIC execution—tinme 1 

| | | | | | 41,46,51,61,71,81... | Files. (Trailing blanks are| 

| | | | | | 131 | not truncated.) | 


Figure 33. 


* indicates that the 


l 
I 
L/L indicates that the | 
i a a a a ae a ew en ee eS eee 


Default 


ZONE, TRUNC, or VERIFY setting is egual to the current record length. 
LINEMODE setting is LEFT, with serial numbers on the left. 


EDIT Subcommand Settings for CMS Reserved Filetypes 
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Appendix B: VSE/VSAM Functions Not Supported in CMS 


Refer to the publication Using VSE/VSAM Commands and Macros for a 
description of access method services functions available under VSE, 
and, therefore, under CMS. .This knowledge of access method services is 
assumed throughout this publication. 

All of VSE/VSAM is supported by CMS, except for the following: 


e Non-VSAM data sets with data formats that are not supported by 
CMS/DOS (for example, PDAM and ISAM files are not supported). 


e The SHAREOPTIONS operand is not supported for cross system or cross 
partition sharing in CMS/DOS (that is, DASD sharing is. not 
supported). 

e The Local Shared Resources option is not supported by CMS/DOS. 


e Space Management for SAM Feature 


e Backup/Restore Feature 
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Appendix C: OS/VS Access Method Services and 
VSAM Functions Not Supported in CMS 


In CMS, an OS user is defined as a user that has not issued the command: 
SET DOS ON (VSAM) 


OS users can use all of the access method services functions that are 
supported by VSE/VSAM, with the following exceptions: 


e Non-VSAM data sets with data formats that are not supported by 
CMS/DOS (for example, BDAM and ISAM files are not supported). 


e The SHAREOPTIONS operand is not supported for cross system or cross 
partition sharing in CMS/DOS (that is, DASD sharing is not 
supported). 


e Do not use the AUTHORIZATION (entrypoint) operand in the DEFINE and 
ALTER commands unless your own authorization routine existS on the 
DOS core image library, the private core image library, or ina CMS 
DOSLIB file. In addition, results are unpredictable if your 
authorization routine issues an OS SVC instruction. 


e The OS access method services GRAPHICS TABLE options and the TEST 
option of the PARM command are not supported. 


e The filename in the FILE (filename) operands is limited to seven 
Characters. If an eighth character is specified, it is ignored. 


e The OS access method services CNVICAT and CHKLIST commands are not 
supported in VSE/VSAM access method services. In addition, all OS 
access method services commands that support the 3850 Mass Storage 
System are not supported in DOS/VS access method services. 


e Figure 34 is a list of OS operands, by control statement, that are 
not supported by the CMS interface to VSE/VSAM access’7 method 
services. 


If any of the unsupported operands or commands in Figure 34 are 
specified, the AMSERV command terminates and displays an appropriate 
error message. 


When you use the PRINT, EXPORT, IMPORT, IMPORTRA, EXPORTRA, and REPRO 
control statements for sequential access method (SAM) data sets, you 
must specify the ENVIRONMENT operand with the required DOS options (that 
is, PRIME DATA DEVICE, BLOCKSIZE, RECORDSIZE, or RECORDFORMAT). You 
must have previously issued a DIBL for the SAM file. 


AMSERV can write SAM data sets only to a CMS disk, but can read then 
from DOS, OS, or CMS disks. 
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OS Access Method Services 
Control Statement 


Operands Not Supported in CMS 


EMPTY/NOEMPTY 
SCRATCH/NOSCRATCH 
DESTAGEWAIT/NODESTAGEWAIT 
STAGE/BIND/CYLINDERFAULT 


ALIAS 

EMPTY/NOEMPTY 
GENERATIONDATAGROUP 
PAGESPACE 
SCRATCH/YOSCRATCH 
DESTAGEWAIT/NODESTAGEWAIT 
STAGE/BIND/CYLINDERFAULT 
TO/FOR/OWNER! 


| 

| 

| 

l 

| 

| 

| 

| 

| 

| 

| 

| 

| 

l 

| ALIAS 
| GENERATIONDATAGROUP 
| PAGESPACE 
| 

| OUTDATASET 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

[ 

| 

| 

| 

| 

| 


INDATASET 
OUTDATASET 
IMPORTA 


ALIAS 
GENERATIONCATAGROUP 
LEVEL 

OUTFILE2 

PAGESPACE 


INDATASET 
OUTFILE? 


INDATASET 
OUTDATASET 


li1The TO/FOR/OWNER operands are supported for the access method 

| services interface, but are not supported for the DEFINE NONVSAM 
| control statement. 

}2The OUTFILE operand is supported Ly the access nethod services 

| interface, but is not supported for the LISTCAT and PRINT control 
| statements. 


Figure 34. OS Access Method Services Operands Not Supported in CMS 
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(comments) UPDATE control statement 


-/ D (DELETE) UPDATE control statement 345 
-f I (INSERT) UPDATE control statement 344 
(REPLACE) UPDATE control statement 


«f/f S (SEQUENCE) UPDATE control statement 


-BX (BOX) format word 507 

-CM (COMMENT) format word 509 

e-CS (CONDITIONAL SECTION) format word 510 
-FO (FORMAT MODE) format word 511 

~-IL (INDENT LINE) format word 512 

~IN (INDENT) format word 513 

OF (OFFSET) format word 514 

-SP (SPACE LINES) format word 515 

«TR (TRANSLATE CHARACTER) format word 516 


&$ special variable 446 
in &IF control statement 435 
setting 426 
&* special variable 446 
in &IF control statement 435 
setting 426 
SARGS control statement, description 426 
&BEGEMSG control statement 
ALL operand 426 
description 426 
&BEGPUNCH control statement 
ALL operand 428 
description 428 
GSBEGSTACK control statement 
ALL operand 428 
description 428 
FIFO operand 428 
LIFO operand 428 
&BEGTYPE control statement 
ALL operand 429 
description 429 
S&CONCAT built-in function, description 443 
SCONTINUE control statement 430 
used with &SERROR control statement 433 
&SCONTROL control statement 
ALL operand 430 
CMS operand 430 
description 430 
ERROR operand 430 
MSG operand 430 
NOMSG operand 430 
NOPACK operand 431 
NOTIME operand 431 
OFF operand 430 
PACK operand 431 
TIME operand 431 
SDATATYPE built-in function, description 
44y 
EDISK* special variable 447 
EDISK? special variable 447 
&EDISKx special variable 446 


Index 


&DOS special variable 447 
GEMSG control statement, description 431 
SEND control statement 432 
with &BEGEMSG control statement 426 
with &BEGFUNCH control statement 428 
with &BEGSTACK control statement 428 
with &BEGTYPE control statement 428 
&ERROR control statement, description 432 
&S&EXEC special variable 447 
&EXIT control statement, description 433 
&GLOBAL special variable 447 
&GLOBALn special variable 448 
&GOTO control statement 
description 434 
TOP operand 434 
&HEX control statement 
description 434 
OFF operand 434 
ON operand 434 
&IF control statement, descrirftion 435 
&SINDEX special variable 448 
setting 426,438 
&LENGTH built-in function, description 444 
SLINENUM special variable 448 
&LITERAL built-in function, description 
445 
&LOOP control statement, description 436 
&n special variable 446 
&PUNCH control statement, description 437 
&READ control statement 
ARGS operand 438 
description 438 
VARS operand 438 
&READFLAG special variable 448 
testing 439 
&RETCODE special variable 448 
&SKIP control statement, description 439 
&SPACE control statement, description 440 
&STACK control statement 
description 440 
FIFO operand 440 
LIFO operand 440 
stacking CHANGE subcommand 367 
Stacking INPUT subcommand 379 
Stacking REPLACE subcommand 390 
&SUBSTR built-in function, description 445 
&TIME control statement 
description 441 
OFF operand 441 
ON operand 441 
RESET operand 441 
TYPE operand 441 
ETYPE control statement, description 442 
&TYPEFLAG special variable 448 
&0 special variable 446 


$DUP edit macro 407 
SLISTIO EXEC file 
appending information to 188 
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creating 188 
format 189 

S$MOVE edit macro 408 
DOWN operand 408 
TO operand 408 
UP operand 408 


* (asterisk) 
entered in fileid 5 
in ACCESS command 20 
in ALTER subcommand 362 
in CHANGE subcommand 3€6 
in COPYFILE command 41 
examples 44 
in DDR program 53 
in DFLETE subcommand :7C 
in DLBL command 74 
in DSERV command 93 
in EDIT command 95 
in ERASE command 98 
in EXECIO command 106 
in FILEDEF command 122 
in FILELIST EXEC procedure 134 
in FINIS command 143 
in GETFILE subcommand 377 
in INCLUDE command 169 
in LABELDEF command 173 
in LISTDS command 177 
in LISTFILE command 182 
in LOAD command 193 
in NAMEFIND command 215 
in NUCXDROP command 233 
in PEEK EXEC procedure 242 
in PRINT command 246 
in PUNCH command 251 
in READCARD command 274 
in RENAME command 283 
in REPEAT subcommand 389 
in SCROLL/SCROLLUP subccmmand 394 
in START command 310 
in STATE and STATEW commands 312 
in SYNONYM command 318 
in TAPE command 322 
in TAPPDS command 331 
in TRUNC subcommand 399 
in TYPE subcommand 400 
in VERIFY subcommand 402 
in XEDIT command 353 
in ZONE subcommand 404 
with DISK option, of CMS CUERKY command 
258 
with RESET option 
of INCLUDE command 169 
of LOAD command 193 
* (comment) command 4 
*COPY statement 207 


/ (diagonal) 
used in ACCESS command 20 
used in EXECUTE command 140,271 


%, used to pass null argument to EXEC 
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procedure 446 


J) 


Subcommand, description 405 
used with DSN option of DLBL command 75 
used with FILEDEF DISK option 129 


(equal sign) 
in COPYFILE command 41 
examples 45 
in RDR command 264 
in RENAME command 284 
Ssubcommand (see REUSE sukcommand) 


A 
A option of LISTIO command 188 
ABBREV option 
of CMS QUERY command 256 
of CMS SET command 300 
relationship to SYNONYM command 319 
abbreviation 
of command names 4,300,319 
querying acceptability of 256 
setting acceptability of 300 
used with synonyms 319 
abnormal termination (abend) 
effect on DLBL definitions 75 
effect on FILEDEF definitions 127 
encountered by CMSBATCH command 37 
entering debug environment after 409 
ACCESS command 
description 20 
ERASE option 20,22 
examples 21 
first command after IPL 20 
NODISK option 21 
NOPROF option 20 
read-only access 21 
usage with DEFINE command 22 
access method services 
allocating VSAM space 83 
in CMS/DOS 78 
control statements, operands not 
supported in CMS (OS users) 524 
determine free space extents for 179 
invoking in CMS 24 
LISTING file created by 24 
restrictions 
for OS/VS users 524 
for VSE users 524 
ACK option 
of NOTE EXEC procedure 227 
of SENDFILE EXEC procedure 291 
ADD option 
of MACLIB command 206 
of NOTE EXEC procedure 227 
of TXTLIB command 336 
A-disk, accessed after IPLing CMS 21 
ALIGN cption of ASSEMBLE command 30 
alignment of boundaries in assembler 
Frogram statements 30 
ALIGN2 option, of LKED command 140 


J 


C 


ALL 
operand 
of &BEGEMSG control statement 426 
of &BEGPUNCH control statement 428 
of &BEGSTACK control statement 428 
of SBEGTYPE control statement 429 
of SCONTROL contrcl statement 430 
of SERIAL subcomgmand 395 
option 
of GENMOD command 150 
of LISTIO command 188 
of NUCXMAP command 237 
ALL option, of HELP command 164 
ALLOC option of LISTFILE comgand 184 
ALOGIC option of ASSEMBLE command 28 
ALTER subcommand 
description 362 
effect of zone setting 404 
AMSERV 
command 
description 24 
LISTING file 24 
PRINT option 24 
TAPIN option 24 
TAPOUT option 24 
filetype 25 
default CMS editor settings 519 
APPEND option 
of COPYFILE command 43 
of FILELIST command 134 
of LISTFILE command 183 
of LISTIO command 188 
of RDRLIST EXEC procedure 267 
ARGS operand of &READ control statement 
438 
arguments 
on RUN command 289 
on START command 310 
passed to EXEC procedure 
initializing 426 
passing to nested EXEC procedures 
448 
reading from the console stack 438 
testing how many were passed 448 
ASA carriage control characters 489 
ASAP operand of HNDINT macro 474 
ASSEMBLE 
assembler input ddname 31 
command 2 
ALIGN option 30 
ALOGIC option 28 
BUFSIZE option 30 
DECK option 29 
description 27 
DISK option 29 
ESD option 28 
FLAG option 28 
LIBMAC option 28 
LINECOUN option 28 
LIST option 28 
listing control cptions for 28 
MCALL option 28 
MLOGIC option 28 
NOALIGN option 30 
NOALOGIC option 28 
NODECK option 29 
NOESD option 28 
NOLIBMAC option 28 


102,426 


NOLIST option 
NOMCALL option 
NOMLOGIC option 
NONUM option 2 
NOOBJECT option 
NOPRINT option 
NORENT option 
NORLD option 2 
NOSTMT option 
NOTERM option 
NOTEST option 
NOXREF option 
NOYFLAG option 
NOMBER option 
OBJECT option 
PRINT option 2 
RENT option 30 
RLD option 28 
STMT option 29 
SYSPARM option 
SYSTERM listing 
TERMINAL option 
TEST option 29 
WORKSIZE option 
XREF option 29 
YFLAG option 3 
filetype 
created by TAPP 
default CMS edi 
used as input t 
assesbler 
conditional assenb 
28 
overriding CMS fil 
uSing under CMS 2 
ASSGN command 
DEN option 34 
description 33 
IGN option 34 
LOWCASE option 34 
PRINTER option 33 
PUNCH option 33 
READER option 33 
SYSxxx option 33 
TAPn option 33 
TERMINAL option 3 
TRICH option 34 
UPCASE option 34 
T7TRACK option 34 
STRACK option 34 
assignment statement 
assignsaents 
logical unit, list 
system and program 


attention interruption, causing 10 


ATTN CSS function 
description 450 
using 450 

ATTREST operand of RD 

AUTO option 
of INCLUDE command 
of LOAD command 1 

automatic 
read function, set 


28 
28 
28 
9 
29 
29 
30 
8 


29 
9 


31 
29 
30 
31 
0 
DS command 331 
tor settings 519 
o assembler 27 
ly staterments, listing 


e defaults 31 
gai 


3 


424 


ing 188 
mer, unmassigning 281 


TERM macro 494 


170 
94 


ting 301 


save function of CMS editor 


canceling 363 
invoking 363 
AUTOREAD option of CM 


S SET command 301 
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AUTOSAVE subcommand 

description 363 

OFF operand 363 
auxiliary directory, creating 148 
AUXPROC, option of FILEDEF command 127 


B 
backspace 
characters, how CMS editor handles 379 
key, used with OVERLAY sukcommand 384 
BACKWARD subcommand, description 364 
PASDATA filetype, default CMS editor 
settings 519 
base address, for dekugging, set with 
ORIGIN subcommand 417 
EASIC filetype, default CMS editor settings 
519 
BCD characters, converting to EEBCDIC 43 
EDAM, files, specifying in CHS 122 
-tlank lines, displaying at terminal during 
EXEC processing 440 
blanks 
as delimiters 3 
FIND subcommand 373 
displaying in LINEDIT message text 479 
Overlaying characters with 383 
trailing 
removing with WRIERM macrc 502 
truncating from variatle-length file 
387 
blip 
characters 
for virtual machine 298 
for virtual machine, displaying 255 
function 
querying setting of 255 
setting 298 
BLIP option 
of CMS QUERY command 255 
of CMS SET command 298 
BLKCT operand, of TAPESL macro 498 
BLKSIZE option 
of FILEDEF command 125,127 
of FORMAT command 144 
of TAPE command 324 
BLOCK option of FILEDEF ccmmand 125,127 
blocksize, specifying with FILEDEF command 
127 
BLP operand, of FILELEF command 129 
tooks, from VSE source statement lilraries, 
copying 303 
BOTTOM subcommand, description 365 
boundary alignment, cf statements in 
assembler progran 30 
BOX (.BX) format word 507 
BREAK subcommand, description 410 
Ereakpoints, setting 410 
BSF, tape control function 323 
BSIZE operand of FSCE macrce 461 
BSR, tape control function 323 
EUFFA operand of LINEDIT macro 486 
buffer 
size 
controlling for assembler 30 
for VSAM programs 76 
FUFFER operand of FSCB macro 460 
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BUFSIZE option of ASSEMBLE command 30 
BUFSP option of DLEL command 76 


C 
CANCEL option of NOTE EXEC procedure 227 
CANON operand of IMAGE subconmand 378 
CARD option of EXECIO command 106 
CASE subconmand 
description 365 
M operand 365 
U operand 365 
CAT option 
of LLBL ccmmand 76 
example of usage 85 
example of usage in CMS/DOS_ 81 
CAW 
operand of SET subcommand 419 
subcommand, description 411 
CAW (channel address word) 
changing in dekug environment 419 
displaying in debug environment 411 
format 411 
CC option 
of EXECIO command 107, 113 
of NOTE EXEC procedure 227 
of PRINT command 246 
CD option of DSERV command 93 
CHANGE 
option 
of DLBL command 75 
of FILEDEF command 124 
Of LABELDEF command 174 
subcommand 
description 366 
effect of zone setting 404 
stacking with &STACK control 
statement 367 
CHAR, result of &SDATATYPE built-in function 
44y 
character 
for blip string 
displaying 255 
setting 298 
overlaying, with OVERLAY subcommand 384 
sets, used in CMS 4 
special, changing on 3270 368 
strings 
assigning to variable symbols 424 
changing 366 
copying 48 
extracting in EXEC procedure 445 
locating 382 
valid in CMS command lines 4 
CHARS option, of SETPRT command 304 
CLEAR option 
of DLBL command 75 
Of FILEDEF command 123 
of INCLUDE command 169 
of LABELDEF command 173 
of LOAD command 193 
of SYNONYM command 318 
Closing CMS files, via FINIS command 143 
CLR operand 
Of HNCDEXT macro 473 
Of HNDINT macro 474 
of HNDSVC macro 476 


c 


CMDCALL command 
description 36 
CMS 


operand of SCONTEKCL control statement 


430 


option of DLBL command 75 
subcommand, descrirtion 369 
CMS (Conversational Mcnitor System) 1 


accessing with no virtual disks attached 


to virtual machine 21 
basic description of 2 


batch facility 


(see CNS Latch facility) 


command language, kasic descriftion 1 


commands 
editor 2 
files 
loader 


(see file) 
(see loader) 


(see CMS comsands) 


Macros (see CMS macro instructions) 
subset (see CMS sukset) 


CMS batch facility 


halting 358 
CMS commands 
ACCESS 20 
AMSERV 24 
ASSEMBLE 27 
ASSGN 33 
CMDCALL 36 
CMSBATCH 37 
COMPARE 38 
CONWAIT 40 
COPYFILE 41 
CP 52 
DDR 53 
DEBUG 67 
DEFAULTS 68 
DESBUF 70 
DISK 71 


37 


displaying during EXEC frecessing 430 


DLBL 74 
DOSLIB 87 
DOSLKED 89 
DROPBUF 92 
DSERV 93 
EDIT 95 
entering 3 


entering by synonyn 319 


ERASE 98 
ESERV 100 
EXEC 102 
EXECIO 105 
FETCH 120 


FILEDEF 122 
FILELIST 134 
FINIS 143 
FORMAT 144 
GENDIRT 148 
GENMOD 149 
GLOBAL 152 
GLOBALV 154 


halting execution 


HELP 163 
IDENTIFY 167 
INCLUDE 169 
LABELDEF 173 
LISTDS 177 
LISTFILE 182 
LISTIO 188 
LKED 190 


359 


LOAD 193 

LOALCLIB 202 
LCADMCD 205 

MACLIB 206 

MAKEBUF 209 

MODMAP 210 
MOVEFILE 211 
NAMEFIND 215 

NAMES 221 

NCTE 226 

not for general users 1? 
hucleus-resident 8 
NUCXDROP 233 
NUCXLOAD 234 
NUCXMAP 237 

OPTION 239 


OSKUN 241 
PEEK 242 

PRINT 246 
PSERV 249 
PUNCH 251 
QUERY 254 
RDR 264 


RDRLIST 267 
REACCARD 274 
RECEIVE 277 
RELEASE 281 
RENAME 283 
RSERV 286 

RUN 288 

search order 7 
SENCFILE 290 
SENTRIES 297 


SET 298 
SETPRT 304 
SORT 306 
SSERV 308 
START 310 
STATE 312 


STATEW 312 
summary 12 
SVCTRACE 314 
SYNONYM 318 
TAPE 322 
TAFEMAC 328 
TAPPDS 331 
TELL 336 
transient area /7 
TXTLIB 336 
TYPE 339 
UPLATE 341 
valid in CMS subset 369 
XEDIT 353 
CMS editor, compatibility mode 95 
CMS EXEC file 
appending information to 183 
creating 182 
format 184 
CMS file (see file) 
CMS functions 
ATTN 450 
description 450 
invoking 450 
NUCEXT 451 
WAITRD 456 
CMS Immediate commands 
commands) 
CMS ICADLIBs 


(see Immediate 


Index 


compressing with LOADLIE command 202 
copying with LOADIIE ccmmand 202 
creating with LKED command 190 
executing a load module from 241 
listing with LOADIIB command 202 
CMS macro instructions 45S 
COMPSWT 460 
entering operands on 46€0 
FSCB 460 
FSCBD 461 
FSCLOSE 463 
FSERASE 464 
FSOPEN 465 
FSPOINT 466 
FSREAD 467 
FSSTATE 469 
FSWRITE 471 
HNDEXT 473 
HNDINT 474 
HNDSVC 476 
LINEDIT 477 
PRINTL 488 
PUNCHC 490 
RDCARD 491 
RDTAPE 492 
RDTERM 493 
REGEQU 495 
TAPECTL 496 
TAPESL 497 
WAITD 499 
WAITT 500 
WRTAPE 501 
WRIERM 502 
CMS subset 
entering 369 
returning to edit mode 391 
CMSAMS, saved system name 301 
CMSBATCH command 
description 37 
recursive abends enccuntered by 37 
CMS/DOS 
beginning program executicn in 120 
defining files for 74 
environment 
description 2 
initializing 301 
leaving 302 
testing whether it is active 261 
testing whether it is active, in EXEC 
procedure 447 
CMSDOS, saved system nane 301 
CMSLEVEL option of CMS QUERY command 261 
CMSLIB, assembler macro likrary ddname 31 
CMSSEG, saved system name 301 
CMSTYPE option of CMS SET command 301 
CMSUT1 file 
created by DISK LOAD command 72 
created by READCARD ccmmand 274 
created by TAPE LOAD ccmmand 324 
created by TAPPDS command 331 
CMSVSAM, saved systegz name 301 
COBOL 
compiler 
querying options in effect for 273 
Specifying options for in CMS;/DCS 
239 
filetype, default CMS editor settings 
519 
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COL option 
of COMPARE command 38 
of TYPE command 339 
COLOR operand of WRIERM macro 502 
columns 
comparing disk files by 38 
displaying particular 
with TYPE command 339 
With TYPE surkcommand 400 
of data, copying 52 
specifying 
for copy operations 52 
for verification setting 402 
for zone setting for edit session 
4O4 
COL1 option of TAPPDS command 332 
command 
akbreviating 4 
defaults, shown by underscore in command 
format box 6 
entering 3 
environment 
CMS 1 
CP 1 
definition 1 
execution, halting 359 
keykoard differences in entering 10 
language, CMS 2 
modules, creating 149 
orerands 3 
options 3 
stacking in terminal input buffer 10 
truncating 4 
valid in CMS sukset 369 
when to enter 10 
COMMENT (.CM) format word 509 
ccmments, in CMS command lines 4 
COMP 
operand, of LINEDIT macro 479 
option 
of DOSLIB command 87 
of FETCH command 120 
of MACLIB command 206 
CCMPARE command 
CCL option 38 
description 38 
comparison operators, in EXEC procedure 
435 
compilers, using under CMS 2 
components 
of VM/SP 1 
of VM/370 1 
COMPRESS option, of LOADLIB command 202 
COMPSWI macro, description 460 
CONCAT option, of FILEDEF command 126 
conditional execution 
&IF control statement 435 
&LOOP control statement 436 
CONDITIONAL SECTION (.CS) format word 510 
console 
terminal input Luffer 
clearing 70 
reading a line from via WAITRD 459 
read, after CMS command execution, 
controlling 301 
stack 
reading data in EXEC procedure 438 
stacking lines, &BEGSTACK control 


C 


C 


statement 438 
stacking lines, &STACK control 
statement 440 


stacking lines, STACK subcommand 397 
testing whether it is empty 448 
CONSOLE, value of &REALFLAG special 
variable 448 
constants 
altering 
with LOAD command 199 
with STORE subcommand 
continuation character 
on COPYFILE specificaticn list 48 
on COPYFILE translation list 50 
control program (see CP (contrcl program) ) 
control statements 
for access method services 25 
for DDR command 54 
for UPDATE command 342 
conventions, notational 4 
Conversational Monitor System (see CMS 
(Conversational Monitor Systen) ) 
CONWAIT command 
description 40 
using 40 
COPIES option, of SETPRI command 304 
COPY 
filetype 
adding to MACLIBs 207 
created by SSERV command 308 
function statement, of DDR command 59 
option, of LOADLIE command 202 
COPYFILE command 
APPEND option 43 
description 41 
EBCDIC option 43 
examples 44 
FILL option 43 
FOR option 42 
FRLABEL option 42 
FROM option 42 
incompatible options 44 
LOWCASE option 43 
LRECL option 43 
NEWDATE option 42 
NEWFILE option 42 
NOPROMPT option 42 
NOSPECS option 42 
NOTRUNC option 43 
NOTYPE option 42 
OLDDATE option 42 
OVLY option 42 
PACK option 43 
PROMPT option 42 
RECFM option 43 
REPLACE option 42 
SINGLE option 44 
specification list 48 
SPECS option 42 
TOLABEL option 42 
TRANS option 43 
TRUNC option 43 
TYPE option 42 
UNPACK option 43 
UPCASE option 43 
usage 44 
COPYNR option, of SETPRI ccmmand 304 
COUNT option of DDR command TYPE/PHRINI 


420 


function control statement 62 
CP (ccntrol progran) 
basic descripticn 1 
ccmmands (see CP commands) 
CP commands 
description 52 
executing 
in CMS command environnent 
in EXEC procedure 52 
in jobs for CMS batch facility 52 
with LINEDIT macro 485 
implied 300 
when to use 52 
CP oftion of EXECIO command 106, 111 
CRDTE operand, of LABELDEF command 174 
creating, a program stack buffer, via 
MAKEEBUF 209 
CSECTs, duplicate, for LOAD command 
CSW 
operand of SET subcommand 
subcommand, description 
CSW (channel status word) 
changing in dekug environment 
displaying in debug environment 
format 412 
CTL 
oftion 
Of UPDATE command 342,347 
of XEDIT command 355 


52,300 


195 


419 
412 


419 
412 


D 
DASD Dump Restore (DDR) program, invokin 
via CDR command 54 
DATE option of LISTIFILE command 184 
DD (data definition), simulating in CMS 
122 
D-disk, accessed after IPL of CMS 21 
ddnames 
defining 
with DLBL command 74 
with FILEDEF command 122 
entering tape ddnames for AMSERV 25 
for DLBL ccmmand, restrictions for OS 
users 76 
relating to CMS file 122 
to identify VSAM catalogs 84 
in CMS/DOS_ 81 
used by assenpbler 31 
DDR conmand 
control statements, entering 55 
CCFY function statement 59 
CCUNT option of TYPE/PRINT function 
control statement 62 
description 54 
DUMP function statement 57 
example of TYPE/PRINT output 62 
FTIR option of DUMP/CCPY/EKESTORE funct 
58 
GRAPHIC option of TYPE/PRINT function 
control statement 62 
HEX option of TYPE/PRINT function 
control statement 62 
INPUT control statement 55 
OUTPUT control statement 55 
PRINT function statement 61 
RESTORE function statement 59 


Index 


g 


ion 


531 


of FILEDEF command 123 
of FILEDEF command, examples 128 


SYSPRINT control statement 57 
TYPE function statement 61 


2 


DEBUG cf FILEDEF ccmmand, interactive use 
command 2 of 129 
description 67 of LKED command 191 
subcommands of LOADLIB command 203 
BREAK 410 cf MACLIB command 206 
CAW 411 of PSERV command 249 
CSW 412 of RSERV command 286 
DEFINE 413 of SSERV command 308 
DUMP 414 of TAPE command 324 
GO 415 of TXTLIB command 336 
GPR 416 of UPDATE command 342 
HX 416 DISKR cption of EXECIO command 106,111 
ORIGIN 417 disks 
PSW 418 accessing 20,21 


RETURN 418 detaching 281 

SET 419 determining 

STORE 420 if disk is accessed, in EXEC 
Kk 421 procedure 446 


if disk is CMS OS or DOS, in EXEC 
procedure 446 
if disk is full 257 
read/write status of 257 
dumping to and restoring from tape 53 
erasing files from 98 
files (see file) 
formatting 144 
read/write, sharing 22 
releasing 281 


DECK option 

of ASSEMBLE command 29 

of OPTION command 239 
DEFAULTS EXEC procedure 

description 68 

LIST option 68 

SET option 68 

valid CMS command options 68 
DEFINE, subcommand, descriftion 413 
DEL crtion 


of DOSLIB command 87 effect on logical unit assignments in 
cf MACLIB command 206 CMS/DOS 34 
of IXTLIB command 336 in CMS/DOS = 281 


DELETE 
control statement, 


for UPDATE command 


when DIBL definitions are active 82 ) 
storage capacity, displaying status 257 


345 
subcommand, description 370 
deleting, program stack L-uffer 92 
DEN option 
of ASSGN command 34 
of FILEDEF command 126 
of TAPE command 325 
DESBUF command, description 70 
DESC option, of HELP command 164 
DET option of RELEASE ccnmmand 281 
DETACH command 281 
DIRECT, filetype, default CMS editor 
settings 519 
directories 
CMS auxiliary 148 
CMS file, writing to digk 281 
of VSE libraries, sorting 93 
discontiguous, shared segment, saved systen 
names 301 
DISCARD command 
use with FILELIST EXEC frecedure 141 
use with PEEK EXEC procedure 244 
use with RDRLIST EXEC frocedure 272 
DISK 
command 
DUMP option 71 
LOAD option 71 


of ASSEMBLE command 29 
of CMS QUERY command 257 
of DOSLIB command 87 

of DOSLKED command 89 

of DSERV command 93 
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writing files to 372 
DISKW option of EXECIO command 
DISP 
operand of LINEDIT macro 484 
option of FILEDEF command 125 
DISPLAY operand of FORMAT subcommand 375 
DLBL 
ccmmand 
CAT option 76 
CHANGE option 75 
CLEAR option 75 
CMS option 75 
ddname restrictions (OS users) 82 
description 74 
displaying volumes on which 
Bultivolume data sets reside 80 
displaying VSAM data set extents 79 
LSN option 75 
DUMMY option 75 
entering SYSxxx operand 77 
establishing file definitions for 
STATE command 312 
EXTENT option 76 
KULT option 76 
NOCHANGE oftion 75 
PERM option 75 
SYSxxx option 75 
to identify files for AMSERV 25 
VSAM option 75 
when to use (OS users) 82 
definitions 
cleared by ESERV EXEC 100 
clearing 75,82 


107,112 


displaying 271 
option, of CMS QUERY command 261 
DMSLDR SYSUT1 file 194 
DOS (Disk Operating System) 
disks, accessing 22 
files 
listing information 177 
specifying FILEDEF oftions for 137 
DOS option 
of CMS QUERY command 2Z€2 
of CMS SET command 301 
of GENMOD command 150 
DOSLIB 
command 
COMP option 87 
DEL option 87 
description 87 
DISK option 87 
MAP option 87 
PRINT option 8&7 
TERM option 87 
files 88 
adding phases to 91 
fetching phases fren 120 
identifying for fetching 152 
listing information akcut nemkers 87 
output filemode 8&9 
Size considerations 88 
Space considerations 90 
which DOSLIBs will ke searched 261 
option 
of CMS QUERY command 262 
of GLOBAL command 152 
DOSLKED command 
description 8:9 
DISK option 89 
PRINT option 90 
TERM option 90 
COSLNCNT option 
of CMS QUERY command i292 
of CMS SET command 302 
DOSLNK 
filetype 
CMS/DOS linkage editor input 8:9 
creating 90 
DOSPART option 
of CMS QUERY command 2Z2€2 
of CMS SET command 302 
DOT operand of LINEDIT macro 479 
DOWN 
operand of $MOVE edit macro 408 
Subcommand, descripticn 371 
DROPBUF command 
description 92 
using 92 
DSECT, for file system contrcl block 
461 
DSERV command 
CD option 93 
description 93 
DISK option 93 
PD option 93 
PRINT option 93 
RD option 93 
SD option 93 
SORT option 93 
TD oftion 93 
TERM option 93 


(FSCB) 


DSN oftion of DLBL command 75 
DSORG option of FILEDEF command 126 
DSTRING subcommand, description 371 
DUMMY ofticn 
of DLBL command 75 
restrictions for OS VSAM user 77 
using in CMSyDOS 79 
of FILEDEF command 123 
DUMP 
function statement, of DDR command 5/7 
opticn 
of DISK command 71 
of OPTION command 239 
of TAPE command 323 
subcommand, description 414 
DUP option 
of INCLUDE command 170 
of LOAD ccmmand 194,195 
DVOL1 operand, of TAPE command 324 


E 
EBCDIC 
display file in 339 
option, of COPYFILE command 43 
EDIT 
comgand 2 
description 95 
LRECL option 96 
NCDISP option 96 
operand 
of RDTERM macro 493 
Of WRIERM macro 502 
sukcommand environment 2 
subcommands (see EDIT subconmands) 
EDIT EXEC S2, suppressing execution of 96 
EDIT sukcommands 2 
= 392 
affected by zone setting 404 
ALTER 362 
ADICSAVE 363 
BACKWARD 364 
BOTTOM 365 
CASE 365 
CHANGE 366 
CMS 369 
DELETE 370 
displaying last one executed 405 
DCHN 371 
DSTRING 371 
FILE 372 
FIND 373 
FMODE 373 
FNAME 374 
FORMAT 375 
FCRWAED 376 
GETFILE 377 
IMAGE 378 
INPUT 379 
LINEMODE 380 
LOCATE 382 
LONG 383 
NEXT 383 
nonon 406 
OVERLAY 384 
PRESERVE 385 
PROMPT 386 
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QUIT 386 
RECFM 387 
re-executing 
RENUM 388 
REPEAT 389 
REPLACE 390 
RESTORE 391 
RETURN 391 
REUSE 392 
SAVE 393 
SCROLL 394 
SCROLLUP 394 
SERIAL 395 
settings saved by PRESERVE subccaomand 
385 
SHORT 396 
STACK 397 
TABSET 398 
TOP 399 
TRUNC 399 
TYPE 400 
UP 401 
VERIFY 
X 403 
Y 403 
ZONE 404 
editor 

CMS 

compatibility mode 95 

IMAGE subcommand, default settings 


392,403 


402 


378 

TABSET subcommand, default settings 
398 

TRUNC subcommand, default settings 
399 


verifying changes made by 402 
ZONE subcommand, default settings 
404 
System Product 
invoking 353 
using 355 
EMSG option of EXECIO command 
END, option of TAPPDS command 
end of file 
effect of LOCATE sukcommand 382 
position current line fointer at 


107,113 
333 


365 


ENTRY, loader control statement 197 
entry point 
determined by loader 195 
displayed with FFICH command 120 


specifying 


with ENTRY statement 197 
with GENMOD command 148 
EOF option of TAPE ccugand 324 


FOT cption of TAPE ccmmand 324 
EFQU statements, generating for registers, 
REGEQU macro 495 
ERASE 
command 
description 98 
NOTYPE option 98 
TYPE option 98 
cptiocn 
of ACCESS command 
ERG, tape control function 
ERROR 
operand 
of TAPESL macro 


20,22 
323 


498 
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ERRS option of OPTION command 


of WAITD macro 499 
operand 


SCONTROL control statement 430 


FSCLOSE macro 463 
FSERASE macro 464 
FSOPEN macro 465 
FSPOINT macro 466 
FSREAD macro 468 
FSSTATE macro 470 
FSWRITE macrc 471 
HNDINT macro 474 
HNDSVC macro 476 
ERINTL macro 488 
PUNCHC macro 490 
KRDCARD macro 491 
RITAPE macro 492 
TAPECTL macro 496 
WAITD macro 499 
WRTAPE macro 501 


239 


ESD option of ASSEMBLE command 28 


ESERV, command, description 
EXCLUDE SY¥SIN control statement 


EXDTE 
EXEC 


built-in functions 


100 

203 
operand, of LABELDEF command 175 
443 

SCONCAT 443 

SDATATYPE 444 

SLENGTH 444 

SLITERAL 445 

SSUBSTR 445 


ccmMmand 2 


control statements 


description 102 

implied 300 

424 
SARGS 426 

& BEGEMSG 

& BEGPUNCH 

& BEGSTACK 
EBEGTYPE 429 

SCONTINUE 430 

ECCNTROL 430 

SEMSG 431 

SEND 432 

SERROR 432 

SEXIT 433 

6GOTO 434 

S6HEX 434 

6IF 435 

ELOOP 436 

&PUNCH 437 

G6READ 438 

ESKIP 439 

S&SPACE 440 

&STACK 440 

STIME 441 

STYPE 442 

assignment statement 424 

displaying during EXEC processing 
430 


426 
428 
428 


files 


$LISTIO EXEC created Ey LISTIO 
command 188 

CMS EXEC created by LISIFILE command 
182 


executing with RUN command 288 
filetype 
default CMS editor settings 519 


J 


9 


C 


record format 102 
option 
of LISTFILE cogmand 183 
of LISTIO command 188 
procedures 
branching with &GOTIO ccatrol 
statement 434 
Eranching with &SRKIF ccntrol 
statement 440 
comparing tokens in 435 
concatenating tokens in 443 
defining synonyms for 318 
ESERV 100 
executing 7,102,424 
exiting from 433 
halting terminal outfut during 440 
passing arguments tc nested EXEC 
procedures 448 
reading data from terminal during 
438 
resuming terminal outrut during 440 
RUN 288 
special variables 446 
&S$ 446 
&* 446 
SDISK* 447 
EDISK? 447 


&DISKx 446 
&DO0S 447 
GSEXEC 447 


SGLOBAL 447 
&GLOBALn 448 
EINDEX 448 
SINDEX, setting 426 
SLINENUM 448 
En 426,446 
EREADFLAG 448 
ERETCODE 448 
ETYPEFLAG 448 
60 446 
&1 through &30 426 
EXECIO command 
CARD option 106 
CC option 107,113 
CP oftion 106,111 
description 105 


DISKR option 106,111 
DISKW option 107,112 
EMSG option 107,113 


EXEC 2 example 115 
Machine code 107,113 
PRINT option 107 
PUNCH option 107 
use in EXEC 2 EXECs 115 
EXECUTE command 
use in FILELIST EXEC frocedure 138 
use in RDRLIST EXEC procedure 270 
EXEC 2, procedures, executing 102 
extensions 
read-only 
accessing 21 
editing files on 95 
releasing 281 
EXTENT option 
of DLBL command 
in CMS/DOS 78 
of LISTDS command 177 
EXTERNAL, command 409 


76,83 


F 
FCB 
Macro, loaded by PRINT command 248 
option, of SETPRT command 304 
FETCH command 
CCMF option 120 
description 120 
ORIGIN option 120 
FID operand, of LAEELDEF command 173 
FIFO operand 
operand 
of &BEGSTACK control statement 438 
of &STACK control statement 438 
option 
of IDENTIFY command 167 
of NAMEFIND command 215 
Of NUCXMAP command 237 
of RDR command 264 
file 
creating 
with CMS editor 95 
with COPYFILE command 41 
with FSWRITE macro 471 
with REACCARD command 274 
defining for CMS/DOS 73 
identifier 
entering on FILEDEF command 129 
entering on LISTDS command 178 
in command syntax 5 
inserting lines in 
with INPUT subcommand 379 
with UPDATE command 344 
listing information about 182 
loading 
from tape to disk 323 
from virtual reader to disk 71 
modifying 41 
moving from device to device 211 
hupkering lines in 395 
opening, during program execution 465 
overlaying data in 
specifying number of lines to overlay 
389 
with COPYFILE command 42,49 
with OVERLAY sukcommand 384 
packing 43 
specifying £111 character 47 
printing 246 
in hexadecinal format 247 
specifying number of lines rer page 
247 
processed by TAFE command, listing 324 
protecting data during edit session 405 
punched 
restoring to disk 71,274 
punching to virtual card punch 71,251 
reading 
during program execution 467 
from virtual card reader 71 
sequentially 468 
relating to OS ddname 122 
renaming 283 
displaying new names for 283 
renumbering lines in 388,395 
replacing lines in 
with REPLACE subcommand 390 
with UPDATE command 345 
replacing old file with new copy 42 
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serializing lines in 395 
with line-numker editing 396 
sorting records in 306 
tape, writing to disk 223 
transferring, with DISK DUMP command 71 
unpacking 43 
updating, FSWRITE macre 471 
verifying existence of 
with FSOPEN macro 465 
with FSSTATE macro 469 
with STATE and STIATEW commands 312 
writing to disk 
with AUTOSAVE sukcommand 363 
with FILE subconmmand 372 
with FSWRITE macro 471 
with SAVE subcommand 393 
FILE option of NAMEFIND command 216 
FILE NCT FOUND error message, SUEFLEssing 
during EXEC processing 430 
FILE subcommand, description 372 
FILEDEF 
command 
AUXPROC option 127 
BLKSIZE option 125,127 
BLOCK option 125,127 
BLP operand 129 
CHANGE option 124 
CLEAR option 123 
CONCAT option 126 
default FILEDEF commands issued by 
assembler 31 
definitions for MCVEFILE command 211 
DEN option 126 
description 122 
DISK option 123,12€ 
DISP MOD option 125 
DSORG option 126 
DUMMY option 123 
establishing file definitions for 
STATE command 312 
examples 128,129 
GRAF option 123 
KEYLEN option 125 
LABOFF operand 130 
LEAVE option 126 
LIMCT option 125 
LOWCASE option 126 
LRECL option 125 
MEMBER option 126 
NL operand 130 
NOCHANGE option 124 
NOEOV option 126 
NSL operand 130 
OPTCD option 125 
PERM option 124 
positioning read/write pointer 126 
PRINTER option 123 
PUNCH option 123 
READER option 123 
RECFM option 125 
SL operand 130 
SUL operand 130 
TAPn option 129 
TERMINAL option 123 
TRICH option 126 
UPCASE option 126 
VOLID operand 130 
when to use (CS users) 82 
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when to use in CMS/DOS 78 
XTENT option 125 
T7JTRACK option 126 
O9TRACK option 126 
definitions 
clearing 123,127 
displaying 131 
option of CMS QUERY command 259 
fileid, in command syntax 5 
FILELIST 
EXEC procedure 
APPEND option 134 
description 134 
DISCARD command use with FILELIST 
141 
examples 139 
EXECUTE command use with FILELIST 
138 
FILELIST option 134 
NOFILELIST oftion 135 
option 
of FILELIST EXEC procedure 134 
of SENDFILE EXEC procedure 291,294 
filenode 
changing 
With COPYFILE command 45 
with FMODE subcommand 373 
displaying, FMODE subcommand 373 
letter 
establishing 20 
replacing 281 
numters, changing 284 
specifying, for FSWRITE macro 472 
specifying on KREADCARD command 275 
filenane 
changing, with FNAME subcommand 374 
of EXEC file 
testing 446,447 
file status table (FST) 470 
filetypes, reserved, default CMS editor 
settings for 519 
FILL option of COPYFILE command 43 
FIND subcommand 
description 373 
effect of image setting 378 
FINIS command, description 143 
first-in first-out stacking, in EXEC 
Procedure 428,440 
FIFO (see FIFO) 
fixed-length files, converting to 
variable-length 47,387 
FLAG cretion of ASSEMBLE command 28 
FLASH option, of SETPRT command 304 
FSODE 
option of LISTFILE command 184 
subcommand, description 373 
fn ft fm, used to represent file identifier 
5 
FNAME 
option of LISTFILE command 184 
Subcommand, description 374 
FOR cpticn of COPYFILE command 42 
FORM operand 
of FSCB macro 460 
Of FSOPEN macro 465 
of FSPCINT macro 467 
of FSREAD macro 468 
Of FSSTATE macro 470 


of FSWRITE macro 471 
FORM option, of HELP command 164 
FORMAT 

command 


BLKSIZE option 144 
choosing appropriate Llocksize 
description 144 
examples 145 
LABEL option 145 
NOERASE option 145 
performance consideration 
RECOMP option 145 
option 
of LISTDS command 
of LISTFILE command 
subcommand 
description 375 
DISPLAY operand 
LINE operand 375 
FORMAT MODE (.FO) format word 511 
FORTRAN filetype, default CMS editor 
settings 519 
FORWARD subcommand, descriftion 
FRFE option of LISTDS comsand 
FREEFORT 
files, renumbering 
filetype, 
519 
FRLABFL option of COPYFILE command 42 
FRCM cption 
of COPYFILE command 42 


145 


178 
184 


eve 


376 
177 


388 


of GENMOD command 149 
FSCB 

macro 
BUFFER operand 460 
description 460 
FORM operand 460 
NOREC operand 461 
RECNO operand 461 

operand 
of FSCLOSE macro 463 
Of FSERASE macro 462 
of FSOPEN macro 465 
of FSPOINT macro 466 
Of FSREAD macro 467 
of FSSTATE macro 469 
Of FSWRITE macro 471 


FSCB (file system control block) 
creating 460 
format 460 
FSCBD macro, description 
FSCLOSE macro 
description 
ERROR operand 463 
FSCB operand 463 
FSEQ operand, of LAEELDEF command 
FSERASE macro 
description 464 
ERROR operand 464 
FSCB operand 464 
FSF, tape control function 
FSOPEN macro 
description 465 
ERROR operand 465 
FORM operand 465 
FSCB operand 465 
FSPCINT macro 
description 


461 


463 


174 


323 


466 


146 


default CMS editor settings 


466 
467 
466 


ERROR operand 
FCKM operand 
FSCE operand 
RDENT operand 467 
WRENT operand 467 
FSR, tape control function 
FSREAD macro 


323 


description 467 
ERRCR operand 468 
FORM operand 468 
FSCE operand 468 
FSSTATE macro 
descrirtion 46S 
ERKCR operand 470 
FCRM operand 470 
FSCE operand 4€9 


FST (see file status table) 
FSWRITE macro 

descrirftion 471 

ERRCK operand 471 

FORM operand 471 

FSCE operand 471 


FTYPE option, of LISTFILE command 184 
G 
GEN option 

of MACLIB command 206 

of IXTLIB ccmmand 336 
GENDIEI command, description 148 
general registers 

Changing, in dekug envircnment 419 


displaying, in debug environment 416 
generating list of EQU statements for 


49s 
printing contents of 
GENMOD command 
ALL option 
description 
DCS option 
FRCM option 
MAP option 
NCMAE option 
NCSTR option 
OS option 150 
STR oftion 149 
SYSTEM option 
TC cption 149 
GENN operand, of LABELDEF command 
GENV operand, of LAEELDEF command 
GETFILE subcommand, description 
global changes 
with ALTER subcommand 362 
with CHANGE sukcommand 366 
with OVERLAY sukcommand 383 
GLOBAL command 
description 
DOSLIB option 
LOADLIB option 152 
MACLIB option 152 
querying which LOSLIBs were last 
specified 262 
querying which MACLIBs were last 
specified 261 
querying which TXTLIBs were last 
specified 261 
TXILIE option 


414 


150 
149 
150 
149 
149 
149 
150 


150 
174 


174 
377 


152 
152 


152 
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GLOBALV command 
description 
examples 159 
GRPLIST option 
GRPSTACK option 
INIT option 155 
LIST option 157 
PURGE option 157 
SELECT option 155 


155 


157 
157 


SESSION file 158 
STACK option 157 
STACKR option 157 


use in CMS EXECs 159 
GO subccmmand, description 
GPR 

operand of SET sukccmmand 419 

subcommand, description 416 
GRAF option of FILEDEF command 123 
GRAPHIC option of DDR command TYPE,/PRINT 
function control statement 62 


415 


GRPLIST option of GLOBALV command _ 157 
GRPSTACK option of GICEALV command 157 
H 
HB Immediate command 358 
header 
card 
as READ control card 277 
punched by PUNCH command 251,252 
for LISTFILE command output 182 


format 184 
HEADER option 
of LISTFILE command 
of PUNCH command 251 
HELP 
command 
ALL option 
DESC option 
description 
FORM option 
HELP option 
MENU option 
PARM option 
usage 164 
option, of HELP 
HELP format words 
-BX (BOX) 507 
(COMMENT) 509 
(CONDITIONAL SECTION) 
(FORMAT MODE) 511 
(INDENT LINE) 512 
(INDENT) 513 
(OFFSET) 514 
(SPACE LINES) 515 
(TRANSLATE CHARACTER) 
505 


182 


164 
164 


ccmgmand 163 


510 


-TR 516 
summary 
HEX option 
of DDR command TYFE/PRINT function 
control statement 62 
of PRINT command 247 
of TYPE command 3339S 
hexadecinal 
conversion, in assignment statement 
converting to decigal, LINEDIT macro 
480 
converting to EBCrTIC, LINEFDIT macro 
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423 


477 


display file in 339 
printing file in 247 
representations of characters, 
translating 399 
sukstitution 
in EXEC procedure 425 
invoking in EXEC procedure 424 
suppressing in EXEC frocedure 424 
values, displaying in EXEC ;rrocedure 
435 
HNDEXT macro 


CLR operand 473 

description 473 

SET operand 473 
HNDINTI macro 

ASAP operand 474 


CLR operand 474 
description 474 
ERERCR operand 474 
SET operand 474 


used with WAITD macro 500 
HNDSVC macro 

CLR operand 476 

description 476 


ERRCR operand 476 
SEI operand 476 


HO Immediate command 358 
HT Immediate command 359 
stacking in EXEC procedure 440 
HZ 
DEEUG sukcommand 416 
Immediate conmand 359 
effect on DLEL definitions 75 
effect on FILEDEF definitions 107 
I 


ICS control statement (see include control 
section (ICS) statement) 
ID card, CP, example 275 
IDENTIFY command 
description 167 


display user information 167 


FIFC option 167 
LIFO option 167 
STACK option 167 
TYPE option 167 


ID operand 
of TAPEMAC command 328 
of TAPPDS command 332 


IEBPTPCH utility program, creating CMS 


files from tapes created by 331 
IEBUPDTE utility program, creating CMS 
files from tapes created by 331,332 


IEHMCVE utility program 
creating CMS files from tapes created by 
331 
creating CMS MACLIBs from tapes created 
ky 328 
IGN option 
Of ASSGN ccmmand 34 


with DUMMY data sets 78 


IJSYSCL, defining in CMS/DOS 77 
IJSYSCT 
defining 84 
in CMS/DOS. 81 
IJSYSRL, defining in CMS/DOS 77 


IJSYSSL, defining in CMS/DCS 77 
IJSYSUC 
defining 84 
in CMS/DOS 78 
image setting 
effect on FIND sukcompmand 378 


effect on logical tak settings 398 


IMAGE subcommand 
CANON operand 378 
description 378 
OFF operand 378 
ON operand 378 

Immediate commands 


HB 358 
HO 358 
AT 359 
HX 359 
RO 359 
RT 360 
SO 360 


Summary 11 
IMPCP option 
of CMS QUERY command 255 
of CMS SET command 300 
IMPEX option 
of CMS QUERY command 255 
of CMS SET command 300 
implied 
CP function 52 
query status of 255 
setting 300 
EXEC function 102 
query status of 255 
setting 300 
INC option of UPDATE command 342 
INCLUDE command 
AUTO option 170 
called to load files dynamically 
CLEAR option 169 
description 169 
DUP option 170 
effect on loader takles 299 
examples 171 
follcwing LOAD cozmand 171 
identify TXTLIB s to be searched 
INV option 170 
LIBE option 174 
MAP option 170 
NOAUTO option 170 
NOCLEAR option 169 
NODUP option 170 
NOINV option 170 
NOLIBE option 170 
NOREP option 170 
NOTYPE option 170 
ORIGIN option 170 
REP option 170 
RESET option 169 
SAME option 170 
START option 170 
TYPE option 170 
include control section (ICS), loader 
control statement 198 
INCR option, of XEDIT command 355 
increment 
specifying for line-numter editing 


457 


152 


386 


specifying for sequence numbers in file 


395 


INDENT (.IN) format word 393 
INDENT LINE (.IL) format word 392 
INIT oftion 
of GLOEALVY command 155 
of SETPRI ccmmand 304 
INMOVE, MOVEFILE command ddname 211 
INPUT 
control statement, for DDR command 55 
oftion 
of CMS QUERY command 256 
of CMS SET command 300 
sukcompand 
déscription 379 
effect of image setting 378 
on = subcommand line 393 
stacking with &STACK control 
statenent 379 
input mode 2,361 
during line-numker editing 381 
entering 379,390 
leaving 361 
INSERT control statement, for UPDATE 
command 344 
instructions 
addresses, halting program execution at 
410 
altering 
with LOAD command 199 
with STORE subcommand 420 
Interactive Problem Control System (IPCS) 
1 
interruptions 
entering debug environment after 409 
handling 
external 473 
I/O 476 
SVC 476 
INV option 
of INCLUDE command 170 
of LOAD ccmmand 194 
I/O, devices, handling interruptions for 
474 
IOCP (Input/Output Configuration Progran) 
10 


IPCS (Interactive Problem Control Systen) 
1 
ITEMCT option of TAPEMAC command 329 


K 
KEYLEN option of FILEDEF command 125 


L 
LABEL ocpticn 
Of FORMAT command 145 
of LISTFILE command 184 
LABELDEF 
command 
CHANGE option 174 
CLEAR operand 173 
CRDTE operand 174 
description 174 
EXDTE operand 175 
FID operand 173 
FSEC operand 174 
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GENN operand 174 
GENV operand 174 
NOCHANGE option 174 
PERM option 174 
SEC operand 174 
VOLID operand 174 
VOLSEQ operand 174 
operand of CMS QUERY ccmmand 25S 
LABID operand, of TAPESL macro 498 
LABOFF operand, of FILEDEF ccmmand_ 130 
last-in first-out stacking, in EXEC 
procedure 428,440 
LIFO (see LIFO) 
LDRTBLS option 
of CMS QUERY command 2Z£5&5 
of CMS SET command 299 
LDT statement (see loader terminate (LDT) 
statement) 
LEAVE option 
of FILEDEF command 126 
of TAPE command 325 
LEAVE option of DDR copmand INPUT/OUTPUT 
control statement 56 
LEFT operand of LINEMODE sukcommand 380 
LENGTH operand of RDIERM macro 495 
LET option, of LKED command 191 
LIBE option 
of INCLUDE command 170 
of LKED command 191 
of LOAD command 194 
LIEMAC option of ASSEMBLE command 28 
libraries 
OS, macro libraries 
likraries, OS) 
VSE 
asSigning logical units 35 
obtain informaticn aktout 93 
VSE core image 
defining IJSYSCL 77 
fetching phases fron 
VSE procedure 
copying procedures from 249 
displaying directories of 93 
displaying procedures from 249 
printing procedures from 249 
punching procedures frcep 249 
VSE relocatable 
asSigning SYSRLB 286 
copying modules fron 286 
defining IJSYSRL 77 
displaying modules from 286 
link-editing mcdules from 89 
printing modules frem 286 
punching modules from 28€ 
VSE source statenent 
assigning SYSSLB 308 
copying books 308 
copying macros fron 100 
defining IJSYSSL 77 
displaying books 308 
printing books 308 
punching books 308 
LIERARY 
loader control statement 197 
option of CMS QUERY conmand 260 
LIFO operand 
operand 
of &BEGSTACK control statement 428 


(s€e macro 


120, 121 
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of &STACK control statement 428 
option 

of IDENTIFY command 167 

Of NAMEFIND command 215 

of NUCXMAP command 237 

cf BDR conmand 264 


LIMCI cption of FILEDEF command 125 
line 


duplicating, in CMS file 407 
imwage, of record 378 
locating by beginning character string 
373 
node 
of CMS editor 96 
of 3270 375 
moving, within CMS file 408 
number, of EXEC statement, testing 448 
printing 
with LINEDIT macro 484 
with PRINTL macro 488 
punching 
in EXEC frocedure 438,437 
punching with PUNCHC macro 490 
reading frcem ccnsole stack 397 


LINE operand of FORMAT subcogmand 375 
LINECCUN option 


of ASSEMBLE command 28 
of PRINT command 247 


LINEDIT macro 


BUFFA operand 485 
CCME operand 479 
description 477 
DISF operand 4&4 
DCI operand 479 
MAXSUBS oferand 487 
MF operand 486 

RENT operand 487 
SUE operand 480 
substitution list, specifying 480 
TEXT operand 478 
TEXTA operand 479 


LINEMSCDE subconmand 


description 380 
LEFT operand 380 
OFF operand 381 
RIGHT operand 381 


line-nupber editing 


displaying line numbers 381 
inserting single line 406 
left-handed 380 

reserializing records in file 396 
right-handed 381 

setting prompting increment for 386 


LINEXUM option of NAMEFIND ccmmand 216 
LINK ccmmand, accessing disks after 21 
linkage editor control statements 


OS 
read by TXTLIB command 337 
reguired format for TXTLIB command 
337 
VSE supported in CMS/DOS 90 


link-editing 


in CMS/DOS 89 

modules fron VSE relocatable libraries 
90 

TEXT files in storage 193 

TXTLIB members 337 


-) 


list form of LINEDIT macro 486 


C 


LISI option 
of ASSEMBLE command 28 
Of DEFAULTS EXEC procedure 68 
of GLOBALV command 157 
of LKED command 191 
of LOADLIB command 202 
of OPTION command 239 
LISTDS command 
description 177 
examples 179 
EXTENT option 177 
FORMAT option 178 
FREE option 177 
PDS option 178 
LISTFILE command 
ALLOC option 184 
APPEND option 183 
DATE option 184 
description 182 
examples 185 
EXEC option 183 
FMODE option 184 
FNAME option 184 
FORMAT option 184 
FTYPE option 184 
HEADER option 182 
LABEL option 184 
NOHEADER option 182 
LISTING filetype 
created by access methcd services 24 
created by ASSEMBLE command 28 
controlling 28 
created by ESERV frogram 100 
default CMS editor settings 519 
printing 246 
LISTIO command 
A option 188 
ALL option’ 188 
APPEND option 188 
description 188 
EXEC option 188 
FROG option 188 
STAT option 188 
SYS option 188 
SYSxxx option 188 
UA option 188 
LISTX option, of OPTION ccmamand 239 
literal values, using in EXEC procedure 
H45 
LKED command 
ALIGN2 option 190 
description 190 
DISK option 191 
LET option 190 
LIBE option 191 
LIST option 191 
MAP option 191 
NAME option 191 
NCAL option 190 
NE option 190 
NOPRINT option 191 
NOTERM option 191 
OL oftion 190 
OVLY option 190 
PRINT option 191 
REFR option 190 
RENT option 190 
REUS option 191 


SIZE opticn 191 
TERM ofticn 191 
using 192 
XCAL option 191 
XREF option 191 
LOAD 
coumfand 
AUTC option 194 
called to load files dynamically 459 
CLEAR option 193 
description 193 
CUP option 194,195 
duplicate CSECTs 195 
effect cn leader tables 299 
executing program using 194 
identify TXTLIBs to be searched 152 
INV option 194 
LIBE option 194 
MAP option 194 
NCAUTO option 194 
NOCLEAR opticn 193 
NODUP option 194 
NCINV option 194 
NOLIBE option 194 
KOMAF option 194 
NOREP cption 194 
NOTYPE option 194 
CRIGIN option 194 
REP option 194 
RESET option 193 
START option 194 
IYPE option 194 
used with GENMOD command 150 
option 
of DISK command /71 
of TAPE command 323 
load map 
creating 195 
with INCLUDE command 170 
with LCAD command 194 
displaying 194 
generated by GENMOD command 149 
invalid card images in 195 
of MODULE file, displaying 210 
replace card image in 170 
load pecint, specifying 170,194 
loader 
CMS 195 
control statements 
ENTRY statement 197 
include control section (ICS) 
Statement 198 
LIERARY statement 197 
loader terminate (LDTI) statement 197 
replace (REP) statement 199 
set location counter (SLC) statement 
199 
set page boundary (SPE) statement 
200 
search order, for unresolved references 
196 
tables 
defining storage for 299 
displaying number of 255 
loader terminate (1LDT), loader control 
Statepent 197 
loading a virtual 3800 printer, via SETPRT 
command 304 
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LOADLIB 
command 
COMPRESS option 202 
COPY option 202 
description 202 
DISK option 203 


EXCLUDE SYSIN control statement 203 


LIST option 202 
MODIFY option 203 
PRINT option 203 
REPLACE option 203 


SELECT SYSIN ccecntrol statement 203 


TERM option 203 
option 
of CMS QUERY command z60 
of GLOBAL command 162 
LOADLIBS 
CMS 


compressing with LOADLIB command 202 


copying with LOALTLIE command 202 

creating with LKED ccmmand 190 

executing a load module from 241 

listing with LOADLIE ccmmand 202 
LOADMOD command 


called to load files dynamically 460 


CMS/DOS conSiderations 205 
description 205 
LOCATE subcommand 
description 382 
effect of zone setting 404 
LOG option 
of NOTE EXEC procedure 228 
of RECEIVE EXEC procedure 278 
of SENDFILE EXEC procedure 291,294 
logical 
operators, in EXEC frocedure 435 
record length, of CMS file, defaults 
used by CMS editor 96 
units 
assigning 33 
ignoring assignments 34 
listing 188 
unassigning 302 
unassigning in CMS/DOS 34,35 
LONG 
option of NOTE EXEC ;frocedure 228 
subcommand , descrirticn 383 
look-aside entries 233 
looping, in EXEC procedure 340 
LOWCASE option 
of ASSGN command 34 
of COPYFILE command 43 
of FILEDEF command 126 
lowercase letters 
Suppressing translaticn tc uppercase 
365 
translating to uppercase 
with CASE subcommand 365 
with COPYFILE command 43 
with PRINT command 247 
LRECL option 
of COPYFILE command 43 
example 47 
cf EDIT command 96 
of FILEDEF command 125 
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M 
M operand of CASE subcommand 365 
Machine code 107,113 
MACLIE 
comsand 
ADL option 206 
CCMEF option 206 
TEL option 206 
description 206 
DISK oftion 207 
GEN option 206 
MAF option 206 
PRINT crtion 207 
reading files created by ESERV 
program 101 
REP option 206 
TERM option 206 
files 
creating 206 
displaying names of MACLIBs to be 
searched 260 
distributed with CMS system 207 
specifying: for assembly or 
compilation 152 
option 
of CMS QUERY command 260 
of GLOBAL command 152 
MACRO 
files, created by ESERV program 100 
filetype 
adding to MACLIBs 207 
default CMS editor settings 519 
invalid records in, handling by 
MACLIB command 207 
macro definitions 
in assembler listing 28 
in MACRO files 207 
Macro libraries 
CMS 
adding to 206 
compacting members of 206 
creating 206 
deleting memters of 206 
displaying information about nembers 
in 206 
Printing memters 248 
fFunching members 248,252 
reading OS macro lilraries into 328 
replacing members of 206 
typing members 340 
creating 
from OS partitioned data sets on tape 
328 
from tapes created by IEHMOVE utility 
program 328 
identifying for assembly 31,152 
Os 
concatenating 126 
reading into CMS MACLIBs 328 
using in CMS 31 
VSE, copying macros from _ 100 
MAKEEUF command 
description 209 
return code, effect on SERROR statement 
209 
MAP 
filetype 
created by DCSLIB command 87 


created by DSERV command 93 
created by LOAD command 195 
created by MACLIB command 206 
created by TAPE ccmmand 324 
created by TXTILIE command 336 
cption 
of DOSLIB command 87 
of GENMOD command 149 
of INCLUDE command 170 
of LKED command 191 
of LOAD command 194 
of MACLIB command 206 
of TXTLIB command 33€ 
maps 
created by DOSLIB ccmgand 87 
created by GENMOD command 149 
created by LOAD cocmgand 195 
created by MACLIE command 206 
created by TXTLIB command 336 
linkage editor, in CMS/DOS_ 89 
Margins, setting left margin for input with 
CMS editor 398 
master catalog (VSAM) 
identifying 85 
identifying in CMS/DOS_ 81 
Easter file directory 
contents of 21 
suppressing updating after RENAME 
ccmumand 284 
updating entries in 283 
updating on disk 281 
BAXSUBS operand of LINEDIT macro 487 
MAXTEN option of TAPPDS ccmumand 333 
MCALL option of ASSEMBLE ccmmand 28 
MEMBER option 
of FILEDEF command 126 
of PRINT command 247 
of PUNCH command 251 
of TYPE command 340 
MEMO filetype, default CMS editor settings 
519 
MENU option, of HELP command 163 
MERGE cption, of XEDIT command 355 
message, text for LINEDIT macro 478& 
MF operand of LINEDIT macro 486 
minidisks (see also 
copying 53 
counting cylinders on 145 
MLOGIC option of ASSESBLE command 28 
MODE 
operand 
of RDTAPE macro 492 
Of TAPECTL macro 456 
of TAPESL macro 497 
of WRTIAPE macro 501 
oftion of DDR command INPOUT/OUTFOUT 
control statement 56 
mode letter (see filemode letter) 
MODESET option of TAPE ccmumand 323 
MODIFY option 
Of LOADLIB command 203 
of SETPRT command 304 
MODMAP command, descriftion 210 
MODULE files 
creating 149 
debugging 205 
defining synonyms for 318 
executing with RUN command 288 


format 149 
generating 149 
leading dynamically during progran 
execution 460 
loading into storage for execution 205 
DMapring 210 
VSE, link-editing 92 
modules, VSE, link-editing 92 
MOVEFILE command 
default device attributes 212 
descriftion 211 
exagples 211 
PDS option 211 
MSG operand of &CONTROL control statenent 
430 
MULT option of DLBL ccmmand 76 
Bultilevel updates using UPDATE command, 
examples 347,348 
multirle 
extents for VSAM files 
specifying 8:3 
specifying in CMS/DOS 78 
FSCEs 461 
input files 
for UPDATE command 342 
with COPYFILE command 45 
outfut files 
with COPYFILE command 31,45,48 
with RENAME command 284 
substitution lists, LINEDITI macro 484 
multivclume data sets, displaying volumes 
on which they reside 80 
multivolume VSAM extents 
identifying with DLBL command 84 
in CSS/DOS 8&0 
Maximum number of disks 84 
in CMS/DOS~ 80 
rules for specifying 84 
in CMS/DOS~ 80 


N 
NAME option, of LKED command 191 
NAMEFIND ccamand 

description 215 

FIFO option 215 

FILE option 21€ 

LIFO oftion 215 

LINENUM option 216 

NAMES file format 216 

NAMES file tags 218 

Sample names file 220 

STACK option 215 

START option 216 

SIZE option 216, 219 

TYPE option 215 
NAMES EXEC procedure 

description 221 

nickname 221 

PF keys on NAMES menu 223 

Sample NAMES screen 224 
NCAL option, of LKED command 190 
NE option, of LKED command 190 
nesting 

&IF statements in EXEC procedure 436 

EXEC procedures 

effect on &CCNTRCL 430 
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passing variable data 448 
testing recursion level 447 
loops in EXEC procedure 437 
never-call function, specifying in CMS TEXT 
file 197 
NEWDATE option 
of COPYFILE command 42 
of RECEIVE EXEC procedure 278 
NEWFILE option of COPYFILE command 
NEXT subcommand, description 383 
nickname 221 


42 


NL operand, of FILEDEF ccmgand 130 
nnnnon subcommand, descrirftion 406 
NO option of START command 310 
NOACK option 

of NOTE EXEC procedure 227 

Of SENDFILE EXEC frocedure 291 


NOALIGN option of ASSEMBLE command j30 
NOALOGIC option of ASSEMELEF command 28 
NCAUTO option 
of INCLUDE command 
of LOAD command 194 
NOCC option of PRINT command 246 
NOCHANGE option 
of DLBL command 75 
of FILEDEF command 
of LABELDEF command 
NOCLEAR option 
of INCLUDE command 
of LOAD command 193 
of XEDIT command 354 
NOCOL1 option of TAPPDS ccmmand 332 
NOCTL cftion, of XELDIT command 355 
NOCTL option of UPDATE comgand 342 
NOLECK option 
of ASSEMBLE command 29 
of OPTION command 239 
NODISK option of ACCESS command 21 
NCDISP option 
of EDIT command $496 
effect on FORMAT sukcommand 
NCDUMP option of CPTICN conmpand 
NODUP option 
of INCLUDE command 
of LOAD command 194 
NOEND oftion of TAPPDS command 
NOEOV oftion, of FILEDEF ccmmand 
NOFRASE option, of FORMAT command 
NOERRS option of OPTICN ccaumand 
NOEFSD option of ASSESBLE ccupand 
NOFILELIST option of FILELISI EXEC 
procedure 135 
NOHEADEFR option 
of LISTFILE command 
PUNCH command 251 
option of UPDATE command 342 
ortion 
INCLUDE command 
LCAD command 194 
NOLIBE option 
of INCLUDE command 
of LCAD command 194 
NOLIBMAC option of ASSEMBLE command 
NOLIST option 
of ASSEMBLE command 28 
of OPTION command 239 
NOLISTX option of OFTICN ccmmand 
NOLCG option 


170 


124 
174 


169 


375 
239 


170 

333 

126 
145 


239 
28 


182 


170 


170 


28 


239 
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of NOTE EXEC procedure 228 : 
of SENDFILE EXEC procedure 219,294 
NCMAF cption 
of GENMOD ccmmand 149 
of LOAD command 194 


NOMAXTEN option of TAPPDS command 333 
NOMCALL option of ASSEMBLE command 28 
NOMLOG option of RECEIVE EXEC procedure 
278 
NOMLCGIC option of ASSEMBLE command 28 
NOMSG operand of &CONTROL control statement 
430 
nonreentrant code, writing for LINEDIT 
macro 487 
nonrelocatable modules, in CMS_ 149 
NONSHARE option of CMS SET command 301 
nonshared copy 
of named system, obtaining 301 
of saved system, oktained during debug 
411 
NONUM option of ASSEMBLE command 29 
NOOBJECT option of ASSEMBLE command 
NCPACK operand of &CONTROL control 
statement 431 
NOPDS cption of TAFPDS command 
NOPRINT option , 
of ASSEMBLE command 29 
of LKED command 191 
of TAPE command 324 
NOPROF option of ACCESS command 20 
NOPROFIL option, of XEDIT command 354 
NOPRCMNET option of COFYFILE command 42 
NCREC cpferand of FSCB macro 461 
NORENT option of ASSEMBLE command 30 
NCREF cption 
INCLUDE command 
LOAD command 194 
UPDATE command 341 
NORLD cption of ASSEMBLE command 28 
NOSCREEN option, of XEDIT command 354 
NOSEC8 
option 
of UPDATE command 341 
cf XEDIT command 355 
NOSPECS option of COPYFILE command 42 
NOSTD option of SYNONYM command 318 
NOSTK cfption of UPDATE command 342 
NOSTMIT option of ASSEMBLE command 30 
NCSTOK option of UPDATE command 342 
NOSTR cption of GENMOD command 150 
NCSYM cEetion of CETION command 239 
notaticnal conventions 4 
NOTE EXEC procedure 
ACK option 227 
ADL option 227 
CANCEL option 
CC option 227 
description 226 
LOG oftion 228 
LCNG option 228 
NOACK option 227 
NOLCG option 228 
NCTEBOOK option 227 
PF key settings for NOTE 


29 


332 


170 


227 


230 


PROFILE option 228  ? 
REELACE option 228 wd 
send a note 229 
SHORT option 228 


NOTE option of SENDFILE EXEC procedure 
291,294 

NOTEBOOK option of NCTE EXEC procedure 227 
NCTEBOOK * option of RECEIVE EXEC procedure 
278 
NCTEBOOK fn option of RECEIVE EXEC 
procedure 277 
NOTERM option 

of ASSEMBLE command 30 

of LKED command 191 

of OFTION command 240 

of UPDATE command 342 
NOTEST option of ASSEMBLE command 29 
NOTIME operand of &CCNTROL control 
statement 431 
NOTRC option, of PRINI ccmmand 247 
NOTRUNC option of CCPYFILE command 43 
NOTYPE option 

of COPYFILE command 43 
ERASE command 98 
cf INCLUDE command 
of LCAD command 194 
RDR command 2€4 
of RENAME command 283 


170 


of SENDFILE EXEC procedure 291,294 
NOUPDATE option, of XEDIT command 354 
NOUPDIRT option of RENAME ccamand 283 


NOWTM oftion of TAPE command 324 
NOXREF option 

of ASSEMBLE command 29 

Of OPTION command 239 
NOYFLAG option of ASSEMELE command 30 


NSL operand 


of FILEDEF command 130 

Of TAPEMAC command 328 

of TAPPDS command 332 
NUCEXT function 

description 451 

linkage conventions 453 


NUCXDROP command 233 
NUCXLOAD command 234 
NUCXMAP command 237 
PLISTs 454 
register contents upon entry 
System and Service Attrikutes 
nucleus 
CMS, protected storage 
fFrotection feature 
displaying status of 
setting 300 
resident commands, 
nucleus extensions 
information about 
installation 234, 
cancel an extenticn 
NUCXDROP command 
description 233 
look-aside entries 
NUCXLOAD command 
description 234 
PUSH operand 234 
SERVICE operand 234 
SYSTEM operand 234 
NUCXMAP command 


454 
452 


300 
256 
list 8 


237 
237 


~ 


Z33 


Pie 


description 237 
ALL option 237 

FIFO option 237 
LIFO option 237 


STACK option 


null 


arguments in EXEC frocedure, setting 
with % 446 

blcck, dumping to tape 325 

line 


Symrols in EXEC statement 
result of &SDATIATYPE built-in 


NUM, 
Quy 


nhumber 


of 


Frccedure, determining 


of 


specifying 


237 


stacking in console stack 397 
Stacking in EXEC 440 

to return to edit mode fron 
mode 361 

when entering VSAM extents 84 

when entering VSAM extents, in 


CMS/DOS 79 


input 


436 
function 


characters in token in FXEC 
4ay 
records to Ee read or written, 
461 


NUMBER cretion of ASSEMBLE command j31 
numeric 


0 


data, 
Variables in EXEC procedure 


determining if token contains 444 


446 


object deck, assembler, generating 29 
OBJECT oftion, of ASSEMBLE command 29 
OFF crerand 


OFFSET (.OF) format word 

OL opticn, of LKED ccmmand 

OLD oftion of SENDFILE EXEC rfrocedure 
291,294 

OLDDATE option 


ON 


operands, command 3 
Operators, comparison, in EXEC rfrocedure 


of 
of 
of 
of 
of 
of 
of 


of 
of 
of 


operand 


of 
of 
of 
of 


435 


OPTCD option of ,FILEDEF command 
OPTICN 


&CCNTEROL control statement 430 
GHEX control statement 434 
6TIME control statement 441 
AUTOSAVE sukcommand 363 
IMAGE subcommpand 378 
LINEMODE sukcommand 381 
SERIAL sukconmand 395 
514 

190 


DISK LCAD command 71 
COPYFILE command 42 
RECEIVE EXEC procedure 278 
434 
Quy 


SHEX contrcl statement 
ETIME control statement 
IMAGE subccmsand 378 

SERIAL subcommand 395 


130 


cconmand 


239 
239 
239 
239 
239 
239 
239 
239 
239 
239 


TECK option 
description 
DUMF oftion 
ERRS option 
LIST option 
LISTX option 
NCDECK option 
NCDUMP option 
NOERRS option 
NCLIST option 
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NOLISTX option 239 
NCSYM option 239 
NOTERM option 240 
NCXREF option 239 
SYM option 239 
TERM option 240 
XREF option 239 
48C option 240 
60C option 240 
option, of CMS QUERY ccumand 262 
options 
command 3 
for DOS/VS COBOL compiler, specifying 
239 
for DOS/VS COBOL compiler in CMS/DCS, 
guerying 262 
LOAD and INCLUDE ccmmand, retaining 170 
origin 
for debug environment 
setting 417 
used to compute symbcl location 414 
CRIGIN 
option 
of FETCH command 120 
of INCLUDE command 170 
of LOAD command 194 
subcommand, descrirpticn 417 
cS 
data sets 
defining in CMS 122 
listing informaticn 177 
disks, accessing 22 
linkage editor control cards, adding to 
TEXT files 337 
macre libraries 
reading into CMS MACLIBsS 328 
used in assembly 31 
option, of GENMOD ccmmand 150 
partitioned data sets (se€e partitioned 
data sets) 
tapes 
containing partiticned data sets 332 
standard-label frocessing 333 
utility programs 
creating CMS files fron tapes created 
by 331 
IEEBPTPCH 331 
IEBUPDTE 331 
IFHMOVE 331 
OSRUN command 
description 241 
PARM keyword 241 
CUTMOVE, MOVEFILE command ddname 211 
OUTPUT 
control statement, for DDR command 55 
option 
of CMS QUERY command 256 
of CMS SET command 300 
OVERLAY subconmmand 
description 383 
effect of image setting 378 
OVLY option 
of COPYFILE command 42 
example 49 
cf LKED command 190 
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P 
PACK 
operand of &CCNTROL control statement 
431 
option 


of COPYFILE command 43 
of CCPYFILE command, example 48 
parameter list 
displaying with LINEDIT macro 483 
passed by RUN command 297 
passed by START command 310 
passed to SVC instruction, recorded 314 
parent disk, of read-only extension 20 
parentheses 
befcre option list 3 
scanned by EXEC interpreter 425 
PARM 
keyword, CSRUN command 241 
Option, of HELP command 164 
partition size, for CMS/DOS, setting 302 
partitioned data sets 
copying into CMS files 211 
copying into partitioned data sets 212 
displaying memter names’ 179 
listing members of 178 
on tapes, creating CMS files 332 
PD oftion of DSERV command 93 
PDS (see partitioned data sets) 
PDS oftion 
of LISIDS ccmmand 178 
Of MOVEFILE command 211 
Of TAFFDS command 332 
PEEK EXEC procedure 
description 242 
DISCARD command use with PEEK 244 
PF key settings in PEEK 243 
PROFILE oftion 242 
periods 
as concatenation character for EXEC 
variables 436 
indicating message substitution in 
LINEDIT macro 488 
placing at end of message text in 
LINEDIT macro 479 
PERM oftion 
of DLBL ccmmand 75 
of FILEDEF command 124 
of LABELDEF command 174 
permanent file definitions 123 
PF key default settings 
in NAMES EXEC procedure 223 
in NOTE EXEC procedure 230 
in PEEK EXEC procedure 243 
in EDRLIST EXEC procedure 268 
in SENDFILE menu 293 
phase library 
clearing to zercs 91 
CMS/DOS 87 
deleting phases from 87 
phases 
executing in CMS/YDCS 120 
in VSE core image libraries, obtaining 
information about 94 
PILI filetype, default CMS editor settings 
519 
PLIOCFT filetype, default CMS editor 
settings 519 ) 
PLISTs 454 


J 


J 


Cc | 


FREUFF operand of RDIERM macro 494 
preferred auxiliary files 349 
prefixes 
identifying sets cf files 
with ACCESS command 21 
With LISTFILE command 184 
prefixing, error messages issued in EXEC 
with DMS 427 
PRESERVE subcommand, description 385 
PRINT 
command 
CC option 246 
description 246 
FCB macro loaded ty 248 
HEX option 247 
LINECOUN option 247 
MEMBER option 247 
NOCC option 246 
NOTRC option 247 
TRC option 247 
UPCASE option 246 
function statement of DDR command 61 
option 
of AMSERV command 24 
Of ASSEMBLE command 29 
of DOSLIB command 87 
of DOSLKED command 91 
of DSERV command 93 
of EXECIO command 107 
of LKED command. 191 
of LOADLIB command 203 
Of MACLIB command 267 
of PSERV command 249 
of RSERV command 28€ 
of SSERV command 308 
Of TAPE command 324 
of TXTLIB command 336 
Of UPDATE command 342 
printer, printing records at 53 
PRINTER option 
of ASSGN command 33 
of FILEDEF command 123 
printers, virtual, closing after using 
PRINTL macro 489 
PRINTL macro 
description 488 
ERROR operand 488 
TRC operand 488 
private libraries (see likraries, VSE) 
PRLGTH operand of RDTERM macro 494 
PROC, files, creating in CMSyDOS 249 
procedures, VSE, cofying into CMS files 
249 
processor time, displaying in EXEC 
procedure 441 
FROFILE EXEC, suppressing execution of 
PROFILE option 
of NOTE EXEC procedure 228 
Of PEEK EXEC procedure 242 
of RDRLIST EXEC procedure 267 
of XEDIT command 354 
PROG option of LISTIO command 188 
Program 
compilation and executicn, with RUN 
command 288 
entry point 
selection during CMS lcader 
processing 195 


20 


specifying 193 
execution 
considerations for clcsing files in 
EXEC procedures 463 
displaying data at terminal 477 
displaying parameter lists 483 
displaying storage 481 
halting 358,410 
handling external interruptions 473 
handling I/O interruptions 474 
handling SVC interruptions 475 
in CMS subset 369 
in CHSy/DOS 120 
modifying control words 419 
modifying general registers 419 
modifying storage 420 
resuming after breakpoint 415 
with INCLUDE command 170 
with LOAD command 194 
with START ccmmand 310 
loading into storage 
while using CMS editor 369 
with INCLUDE command 169 
stack Iuffer, clearing 70 
progras function key (see PF key) 
prograsp stack 
buffer 
creating 209 
eliminating 92 
using WAITRD function to read lines 
from 209 
determining number of lines in 297 
stacking an input line in 455 
Frogram stack buffer, reading a line fron 
Via WAITRD 456 
program status word 
status word) ) 
programmer logical units 
for job catalogs 81 
listing assignments for in CMS/DOS_ 188 
valid assignments in CMS/DOS 34 
PROMPT 
Option of COPYFILE command 42 
sukccrmand, description 386 
prompting 
increment for line-number editing 381 
setting 386 
PROTECT option 
of CMS QUERY ccmmand 256 
of CMS SET command j300 
PSERV command 
description 249 
DISK option 24S 
PRINT cption 249 
PUNCH option 249 
TERM option 249 
PSW 
operand of SET subcommand 419 
suEccmmand, descriftion 418 
PSW (program status word) 
changing, in dekug environment 418 
displaying in dekug environment 418 
PUNCH 
assembler punch output ddname 31 
command 
description 251 
HEADER card format 252 
HEALER oftion 251 


(see PSW (progran 
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MEMBER option 251 
NOHEADER option 251 
option 
of ASSGN command 33 
of EXECIO command 107 
of FILEDEF command 123 
of PSERV command 149 
of RSERV command 286 
of SSERV command 308 
punch, virtual, closing after PUNCHC macro 
490 
FUNCHC macro 
description 490 
ERROR operand 490 
punched files, restoring to disk 71 
PURGE oftion 
of GLOBALV command 157 
Of RECEIVE EXEC procedure 278 
PUSH option of NUCKLCAD command 234 


Q 

CUERY command (CMS) 
ABBREV option 256 
BLIP option 255 
CMSLEVEL option 261 
description 254 
DISK option 257 
DLBL option 261 
DOS option 262 
DOSLIB option 262 
DOSLNCNT option 262 
DOSPART option 262 
FILEDEF option 259 
IMPCP option 255 
IMPEX option 255 
INPUT option 256 
LABELDEF operand 259 
LDRTELS option 255 
LIERARY option 260 
ICADLIB option 260 
MACLIB option 260 
OPTION option 262 
OUTPUT option 256 
PROTECT option 256 
RDYMSG option 255 
REDTYPE option 256 
RELPAGE option 255 
SEARCH option 257 
SYNONYM ALL option 259 
SYNONYM SYSTEM option z§& 
SYNONYM USER option 259 
SYSNAMES option 257 
TXTLIB option 260 
UPSI option 262 

QUIT subcommand, description 386 


9 


R 
RD option of DSERV command 93 
RDOCARD macro 

description 491 

ERROR operand 491 
RDPNT operand, of FSFOINT macro 467 
RDR conmand 

description 264 
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FIFO option 264 
LIFC option 264 
NOTYPE operand 264 
STACK option 264 
use of = 264 
RDRLISTI EXEC procedure 
AFPEND option 267 
default PF key settings 268 
description 267 
DISCARD command use with RDRLIST 272 
display file 242 
EXECUTE command use with RDRLIST 270 
issue commands from RDRLIST 268 
PRCFILE option 267 
special symbols 271 
RLETAPE macro 
description 492 
ERROR operand 492 
MOLE operand 492 
RDTERS macro 
ATTREST operand 494 
description 493 
ELIT operand 493 
LENGTH operand 494 
PREUFF operand 494 
PRLGTH operand A494 
RDYMSG option 
of CMS QUERY command 255 
of CMS SEI command 299 
read, console read after CMS command 
execution 301 
READ ccntrol card 274 
deleting 274 
format 275 
READCARD command, description 274 
reader 
virtual 
reading file from 71,274 
PEEK at a reader file 242 
characteristics of next file 264 
information about reader files 267 
READER oftion 
of ASSGN command 33 
of FILEDEF command 123 
read-only 
disks, editing files on 363 
extensions 
editing files on 85 
releasing 281 
read/write 
status of disks 
controlling 21 
finding first read/write disk in the 
Standard search order 4&7 
finding read/write disk with the gost 
Space 4487 
listing for disk assignsents in 
CMS/DOS 188 
querying 257 
read/write pointer, positioning, FSWRITE 
Macro 472 
ready message 
displaying return code from EXEC 
processing 433 
format 299 
long form 299 
query setting of 255 
setting 299 


C 


short form 299 
special format in EXEC 102 
RECEIVE EXEC procedure 
acknewledge receipt of file 279 
description 277 
LOG cption 278 
NEWDATE option 278 
NOLOG option 278 
NCTEBOOK * 278 
NCTEBOOK fn 277 
OLDDATE option 278 
PURGE option 278 
REPLACE option 278 
STACK option 278 
RECEM 
Operand of FSCB macro 460 
option 
of COPYFILE command 43 
of COPYFILE command, examples 47 
of FILEDEF command 125 
subcommand 
description 387 
F operand 38? 
V operand 387 
RECNO operand of FSCE macrce 461 
RECOMP option of FORMAT ccmumand 145 
record format 
of CMS file 
changing 43,47,387 
listing 183 
of file, specifying 125 
records that can te punched 252 
specifying, for FSWRITE macro 472 
record length 
default used by CMS editor 96 
modifying 96 
of CMS file 
Changing 43,47 
listing 141 
Eaximum lengths for PRINT command 
247 
specifying truncation setting for input 
303 
specifying with FILEDEF command 106 
record number, specifying next record to be 
accessed 359 ; 
records 
displaying selected rfositicns of 244 
in file, numbering with UPDAIE command 
246 
red type 
display lines with WRTERM macro 400 
for error messages 2Z0€ 
REDTYPE option 
of CMS QUERY command 256 
of CMS SET command 300 
reentrant code, writing fer LINEDIT macro 
486 
references 
unresolved 
resolving with INCLUDE command 170 
resolving with LCAD command 194 
REFR option, of LKED ccmgrand 191 
REGEQU macro, description 495 
registers (see general registers) 
RELEASE conmand 
description 281 
DET option 281 


relocatakle 
litraries (VSE), displaying directories 
of 93 
modules, link-editing in CMS/DCS 89 
relocation dictionary, assembler 28 
RELPAGE oftion 
of CMS QUERY command 255 
of CMS SET command 299 
remote terminals, using CMS editor 375 
RENAME command 
descriftion 283 
NOTYPE option 283 
NCUFDIET option 283 
TYPE opticn 283 
UPLIRT option 283 
RENT 
operand of LINELITI macro 487 
ofticn 
cf ASSEMBLE command 30 
of LKED command 191 
RENUM subcommand, description 388 
REP crtion 
of INCLUDE command 170 
of LCALT command 194 
Of MACLIB command 206 
of UFDATE ccmmand 341 
REPEAT sukcopmand 389 
used with OVERLAY subcommand 389 
REPLACE 
control statement, for UPDATE command 
345 
option 
of COPYFILE command 42 
of LOADLIB command 203 
of NOTE EXEC procedure 228 
Of RECEIVE EXEC procedure 278 
subcommand 
description 390 
effect of image setting 378 
restriction while using line-number 
editing 381 
stacking with &STACK control 
Statement 390 
replace (REP) 
loader control statement 199 
image of in load map 170 
RESET 
operand of &TIME control statement 441 
ortion 
of INCLUDE ccumand 169 
of LOAD command 193 
responses, CMS editor, controlling format 
of 383 
RESTCKE 
function statement, of DDR command 59 
subcommand, description 391 
restrictions 
access method services and VSAM 
CSy/VS users 523 
VSE users 523 
RETURN 
command, descriftion 391 
sutcommand (DEBUG) 418 
return code 
from MAKEBUF command, effect on &ERROR 
statement 209 
from SENTRIES ccmmand, effect on &ERROR 
statement 297 
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return codes 
CMS, in EXEC procedure 102 
displaying during EXEC frecessing 430 
from access method services 26 
from CMS commands, testing in EXEC 
Frocedure 449 
from CMS macro instructions 460 
from EXEC, displaying in ready message 
433 
from EXEC interpreter 103 
from EXEC 2 interpreter 103 
specifying in EXEC frocedure 433 
REUS option, of LKED command 191 
REUSE subcommand 
description 392 
examples 392 
REW, tape control function 323 
REWIND option, of TAPE ccmpand 325 
REWIND cption of DDR command INPUT/CUIPUT 
control statement 56 
ribbon, two-color, ccntrolling use of 256 
RIGHT oferand of LINEMCDE sukcommand 381 
RLI option of ASSEMBLE ccuzand 28 
RO Immediate command 359 
RSCS (Remote Spooling Ccmpunications 
Suksystem) 1 
RSERV command 
description 286 
DISK option 286 
PRINT option 286 
PUNCH option 286 
TERM option 286 
RT Immediate command 360 
stacking in EXEC frocedure 440 
RUN 
command, description 288 
tape control function 326 


S 
SAME option of INCLULE command _ 170 
SAVE subcommand, descripticn 393 
saved systen 

nanes 

querying 257 
setting 301 

sharing . 301 
SCAN option of TAPE command 323 
scanning 

S&ERROR control statement 433 

in EXEC procedure 425 
SCRIPT, filetype, default CMS editcr 
settings 519 
SCROLL subcommand, descriftion 394 
SCRCLLUE sukcommand, deéscriftion 394 
SD option of DSERV command 93. 
S-disk, accessed after IPLing CMS 21 
SEARCH option of CMS CUERY command 257 
search order 

for CMS commands 7 

for CMS loader 196 

for executable phases in CMS/DOS 120 

for relocatable mcdules in CMSyDCS 90 

of CMS disks, querying 257 
SEC operand, of LABELDEF ccmugand 174 
SELECT option of GLCEALV ccomsgand 155 
SELECT SYSIN control statement 203 
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send a note 229 
SENDFILE EXEC procedure 
ACK option 291 


default PF key settings on SENDFILE menu 


293 
description 290 
exauples 296 
file format 294 
FILELIST cption 291, 294 
LCG option 291, 294 
NEW option 291, 294 
NOACK option 291 
NCLCG option 291, 294 
NOTE option 291, 294 
NOTYPE option 291, 294 
OLD option 291, 294 
TYPE option 291, 294 
SENTRIES command 
description 297 
return code, effect on &SERROR statement 
297 
SEQUENCE control statement, fcr UPDATE 
command 343 
sequence numbers 
assigned to VSAM extents 84 
in CMS/DOS 79 
SEQ8 
option 
of UPDATE command 341 
of XEDIT ccmugpand 355 
SERIAL sukconmmand 
ALL operand 395 
description 395 
OFF operand 395 
ON operand 395 
SERVICE operand of NUCXLOAD command 234 
SESSION file of GLOBALV command 158 
SET command (CHS) 
AEEREV option 300 
AUICREAD option 301 
BIIF option 298 
CMSTYPE option 301 
description 298 
determining status of SET operands for 
Virtual machine environrment 254 
DCS option 301 
DOSLNCNT orftion 302 
DCSFART option 302 
INFCE option 300 
IMFEX option 300 
INEUT option 300 
LDRIELS option 299 
NCNSHARE option 301 
OUTEUT option 300 
PROTECT option 300 
RDYNSG option 299 
RELTYPE option 300 
RELFAGE option 299 
SYSNAME option 301 
UPSI option 302 
set location counter (SLC), lcader control 
Statemnent 199 
SET operand 
of DEFAULTS EXEC procedure 68 
Of HNDEXT macro 473 
Of HNDINT macro 474 
of HNDSVC macro 476 
set page boundary (SPB), loader control 


2 


statement 199 
SET subcommand (DEBUG) 4195 
CAW operand 419 
CSW operand 419 
GPR operand 419 
PSW operand 419 
SEIPRT command 
CHARS option 304 
COPIES option 304 
COPYNR option 304 
description 304 
FCB option 304 
FLASH option 304 
INIT option 304 
MODIFY option 304 
using 305 
SHORT 
option of NOTE EXEC frocedure 228 
subcommand, descrirtion 396 
SICTCODE option, of XEDIT ccmmand 355 
SINGLE option of COPYFILE copmand 44 
SIZE option of NAMEFIND command 216,219 
SKIP option 
of DDR command INPUT/YOUIPUT control 
Statement 56 
of TAPE command 323 
SL operand 
of FILEDEF command 130 
of TAPEMAC command 328 
of TAPPDS command 332 
SLC statement (see set lccation ccunter 
(SLC) statement) 
SO Immediate command 360 
SORT 
command 
description 306 
storage reguirements 306 
option of DSERV command 93 
sort fields, defining 306 
source file, numbering records with UPDATE 
command 341 
source files 
assembling 
identifying macre likraries 
for assembler 27 
updating 341 
source statement lilraries, VSE, displaying 
directcries of 93 
source symbol table, assemkler, generating 
29 
Space, determine free extents for VSAM 177 
SPACE LINES (.SP) format word 515 
SPACE operand, of TAPESL macro 499 
special variables (see EXFC special 
variables) 
specification list, for COPYFILE command, 
format 48 
SPECS option 
of COPYFILE command 42 
usage 48 
SPOOL conmand 
used with DISK DUMP command 71 
used with PRINT ccmgpand 247 
SSERV command 
description 308 
DISK option 308 
PRINT option 308 
PUNCH option 308 


31,152 


TERM option 308 
STACK 


of GLOEALV command 157 
cf IDENTIFY command 167 
of NAMEFIND command 215 
of NUCXMAP ccamand 237 
of RDR command 264 
of RECEIVE EXEC procedure 278 
subcommand, description 397 
value of &REALFLAG special variable 448 
stacking 
EDIT subcommands 397 
in EXEC procedure, testing whether there 
are lines in stack 448 
lines in console stack 
&BEGSTACK control statement 428 
SSTACK control statement 440 
STACKER option of GLOBALVY command 157 
START 
ccnumand 
descrirtion 310 
NC option 310 
Fassing arguments 310 
opticn 
of FETCH command 120 
of INCLUDE ccmmand 170 
of LOAD command 194 
Of NAMEFIND command 216 
Starting point for execution cf module, 
setting 193 
SIAT option of LISTIO command 188 
STATE command, description 312 
STATEW command, description 312 
status of virtual machine environment 254 
STD option of SYNONYM command 318 
STK option, of UPDATE command 342,350 
SIMT option of ASSEMBLE command 29 
STOR option of UPDATE command 342 
storage 
clearing to zercs 
in CMS/DOS_ 91 
with INCLUDE command 169 
with LOAD command 193 
displaying with LINEDIT macro 481 
examining in dekug envircnment 421 
initializing for MCDULE file execution 
149 
modifying during program execution 420 
printing contents of 414 
releasing pages of after ccmmand 
execution 255,299 
reguirements for SORT command 306 
specifying storage for CMS,/DOS partition 
302 
used by GETFILE subcommand 377 
STORE, subcommand, description 420 
STR oftion of GENMCD command 149 
SUB operand of LINEDIT macro 480 
sublitraries, of VSE source statement, 
copying books 308 
Subset, CMS (see CMS subset) 
substitution 
in EXEC procedure, inhibiting 445 
list for LINEDITI macro 480 
specifying length 483 
of message text in LINEDIT macro 478 
Substrings, extracting in EXEC procedure, 
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&SUBSTR built-in function 445 
SUL operand, of FILEDEF command 
Summary, Of HELP format words 
SVC 

instructions 
handling interrupticns during progran 
execution 476 
tracing 314 
SVCTRACE command 
description 
output 314 
SYM option of OPTION ccmmand 239 
Symkol table, debug 413 
symbolic names, assigning tc storage 


130 
505 


314 


locations, in debug envircnment 413 
sysubols 
debug 
defining 413 
modifying 420 
used to set breakrpceints 410 


in EXEC procedure 
effect of undefined symbols in &IF 
statement 436 
reading from terginal or ccnsole 
stack 438 
substituted in EXEC frocedure, 
displaying 431 
variable (see variakle symbols) 
SYNONYM 
command 
CLEAR option 
description 
example 319 
NOSTD option 
relationship 
318 
STD option 318 
option, of CMS QUERY ccnmand 
Synonym table 
clearing 318 
defining 319 
format for entries in 
invoking 318 
synonyms 
for CMS and user-written commands 
defining 319 
displaying 258,315 
examples 319 
system, displaying 25€ 
SYS option of LISTIC command 
SYSCAT, assigning in CMS/DOS 
SYSIN 
assembler input 31 
logical unit assignment in CMS/DCS 
SYSIPT, assigning for ESERV frogran 
SYSLCG, assigning in CMSyDCS 35 
S¥YSLST lines per page 
displaying number of 
setting number of 202 
SYSNAME option of CMS SET command 301 
SYSNAMES option of CMS QUERY command 257 
SYSPARM option of ASSEMELE ccmmand 31 
SYSPRINT control statement of DIR command 
57 
SYSRES, assigning in CMSyDCS 34 
SYSTEM operand of NUCXICAL command 234 
system and programmer logical units, 
entering on DLBL command 77 


318 
318 


318 
to SFT AEEBREV command 


259 


319 


318 


188 


81 


35 
100 


262 
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system disk 
files available 
releasing 281 
system logical units 
invalid assignments in CMSyDOS 34 
listing assignments for in CMS/DOS 
valid assignments in CMSy/DCS 34 
SYSTEM option of GENMOD command 150 
system residence volume, VSE, specifying 
302 
SYSTERM option of ASSEMBLE command 
SYSxxx option 
Of ASSGN ccnmand 33 
of DLBL ccmmand 75 
of LISTIO command 


21 


188 


29 


188 


T 
tab 
characters, how CMS editor handles 378 
settings, used by CMS editcr 398 
Table Reference Character byte 246 
TABSEIT subcommand 
affected by IMAGE subcommand 378 
description 398 ~ 
tape 
assigning to logical units in CMS/DOS 
34 
backward spacing 323 
control functions 323 
restrictions when using 325 
TAPECTL macro 496 
centrolling, TAPECTL macro 496 
creating CMS disk files 331 
density of, specifying 324 
displaying filenames on 323 
dumping and loading CMS files 323 
dumping and restoring disk data 53 
files 
created by OS utility programs 331 


created by TAPE command 325 
writing to disk 323 
forward spacing 323 


lakels 
displaying definitions in effect 259 
displaying VCL1 label 324 
in FILEDEF ccmmand processing 129 
in TAFEMAC command processing 
328,329 
in TAPESL macro processing 497 


in TAPPDS command processing 332,332 
specifying descriptive informaticn 


173 
writing VOL1 lakel 324 
marks 
writing 324 


OS, standard-lakel processing 332 
positioning 323 
after VCL1 lakel is processed 325 
at specified file 323 
TAPECTL macre 496 
reading records from, RDIAPE macro 
recording technigue, specifying 325 
rewinding 323 
used for AMSERV input and output 
entering ddnames 25 
in CMS/DOS 25 


492 
~ 


i 


24 


— 


ee 


writing records to, WRIAPE macro 


TAPE command 
BLKSIZE option 324 
ccentrol functions 


BSF 323 
BSR 323 
ERG 323 
FSF 323 
FSR 323 
REW 323 
RUN 324 
WIM 324 


DEN option 325 

description 322 

DISK option 324 

DUMP option 323 

dumping null block 325 

DVOL1 operand 324 

EOF option 324 

FOT option 324 

LEAVE option 325 

LOAD option 323 

MODESET option 323 

NOPRINT option 324 

NOWTM option 324 

PRINT option 324 

REWIND option 325 

SCAN option 323 

SKIP option 323 

TAPn option 324 

TERM option 324 

TRTCH option 325 

WIM option 324 

WVOL1 operand 324 

TTRACK option 325 

STRACK option 325 
TAFECTL macro 

description 496 

ERROR operand 496 

MODE operand 496 
TAPEMAC command 

description 328 

ID operand 328 

ITEMCT option 329 

NSL operand 328 

SL operand 328 

TAPn option 329 
TAPESL wacro 

BLKCT operand 498 

description 497 

ERROR operand 498 

LABID operand 498 

MODE operand 497 

SPACE operand 498 

TM operand 498 
TAFIN option of AMSERV ccmmand 
TAPn option 

of ASSGN command 33 

of FILEDEF command 123, 129 

usage 129 

of TAPE command 324 

of TAPEMAC command 329 

of TAPPDS command 333 
TAPOUT option of AMSERV ccnmmand 
TAPPDS command 

COL1 option 332 

description 331 

FND option 333 


24 


24 
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ID operand 332 
MAXTEN option 333 
NCCCL1 option 332 
NCEND option 333 
NCHAXTEN option 333 
NCFDS opticn 332 
NSL operand 332 
PDS option 332 
processing OS standard-label tapes 333 
SI operand 332 
TAPn cption 333 
UPDATE option 332 
TD oftion of DSERV command 93 
TELL EXEC procedure 
description 335 
NAMES file 221 
restrictions 335 
TERM oftion 
of LOSLIB ccmmand 87 
of DCSLKED command 90 
of BSERV command 93 
of LIKED command 191 
of LICADLIB command 203 
of MACLIB ccmmand 206 
of CFTICN command 240 
of PSERV ccmmand 249 
of RSERV ccmmand 286 
of SSEKV command 308 
of TAPE command 324 
of IXTLIB command 336 
Of UPDATE ccmmand 342 
terminal 
displaying lines at, WRTERM macro 502 
displaying reccrds at 53 
output 
determining if terminal is displaying 
44g 
halting 359 
halting in EXEC procedure 440 
restoring 360 
restoring in EXEC frocedure 440 
reading data fron 
during EXEC frocedure 438 
With RDTERM macro 493 
waiting for I/O to complete, WAITT macro 
500 
TERMINAL option 
of ASSEMBLE comgand 30 
of ASSGN ccmmand 33 
of FILEDEF command 123 
TEST ofticn of ASSEMBLE command 29 
TEXT 
assemkler cutput ddname 31 
files 
automatic loading 194 
cards read Ey loader 195 
creating with assembler 29 
executing with RUN command 288 
link-editing in CMS/DOS 89,90 
linking in storage 193 
loading into storage during progran 
executicn 460 
loading into virtual storage 193 
resolving unresolved references with 
LOAD ccmmand 194 
likraries (see IXTLIB) 
operand of LINEDIT macro 478 
TEXT files 
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loading into storage for execution 169 
setting starting point for execution 
193 
TEXTA operand of LINEDIT pwacro 479 
time information, displaying during EXEC 
precessing 441 
time of day, displaying during EXEC 
Processing 456 
TIME operand of SCCNIRCL ccntrol statement 
456 
timers, virtual interval 298 
TM operand, of TAPESL macro 498 
TO 
operand of $MOVE edit macro 408 
Option of GENMOD command 14S 
tokens 
comparing in EXEC frocedure 425 
description 425 
TOLABEL option of COPYFILE ccmmand 42 
TOP 
operand of &GOTO contrcl statement 434 
subcommand, descrirtion 399 
tracing 
resuming after temperarily halting 358 
suspending recording temperarily 359 
SVC instructions 314 
halting 358 
trailing fill characters, removing fron 
records 47 
TRANS cftion of COPYFILE ccmmand 43 
transient area 
CMS commands that execute in 8 
creating modules to execute in 151 
loading programs intc 194 
transient directories in VSF, displaying 
93 
TRANSLATE CHARACTER (.1R) format word 416 
translate tables 
defining input characters for 
translation 299 
defining output characters fcr 
translation 300 
displaying 256 
translation list, for COPYFILE command, 
description 47 
TRC 
operand, of PRINTIL macrc 488 
Cpticn, of PRINT command 246 
TRTCH option 
of ASSGN command 34 
of FILEDEF command 126 
of TAPE command 325 
TRONC 
option of COPYFILE command 43 
example 47 
subcommand, description 399 
truncation 
column, for input mode 399 
of command names 
querying accertabkility cf 256 
setting acceptability cf 300 
of commands 4 
of input records with CMS editor, 
default settings 399 
of records in CMS file 43 
during GETFILE subcommand 377 
following CHANGE sukcommand 367 
of tokens in EXEC frocedure 425 
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two-color rikbon, ccntrolling use of 
256,300 
TXTLIE 
ccnhmand 
ADD option 336 
DEL option 336 
descriftion 336 
LISK option 336 
GEN option 336 
MAP opticn 336 
FRINT option 336 
TERM ofticn 336 
file, searching for unresolved 
references 170 
files 
adding members 336 
creating 336 
deleting members 336 
determining which TXTLIEs are 
searched 260 
identifying for LOAD and INCLUDE 
ccmmand processing 152 
listing members in 336 
Baximum number of memnters 337 
search for unresolved references 194 
searched during INCLUDE command 
fFrocessing 169 
searched during LOAD command 
Frocessing 193 
option 
of CMS CUERY command 260 
cf GLOEAL command 152 


TYPE : 
ccnnand 


COL option 239 

description 339 

HEX option 339 

MEMBER option 340 
function statement of DDR command 61 
operand of &TIME control statement 441 


of trailing blanks from CMS file 43 


of COPYFILE conmand 42 

of COPYFILE command (example) 46 

cf ERASE command 98 

of IDENTIFY command 167 

of INCLUDE command 170 

Of LOAD command 194 

Of NAMEFIND command 215 

c£ RENAME command 283 

Of SENDFILE EXEC procedure 291,294 
subcommand, description 400 

TYPE/PRINT output cf DDR command 62 


U 
U operand of CASE subcommand 365 
UA oftion 


of ASSGN command 34 
of LISTIO ccmmand 188 
underscore 
character, on OVERLAY sukcommand 384 
data records, using backspaces 379 
UNLOAD oftion of DDR command INPUT/OUTPUT 
control statement 56 , 
UNPACK option, of COPYFILE command 43 
unresolved references 


during MODULE file generation 150 
lcader handling of 156 
resolving with INCLUDE command 170 
searching for TEXT files 194 
searching TXTLIBs for 194 
UP 
operand of $MOVE edit macro 408 
subcommand, descrifticn 401 
UPCASE option 
Of ASSGN command 34 
of COPYFILE command 43 
of FILEDEF command 126 
of PRINT command 247 
UPDATE 
command 
control statements 342 
CTL option 342,347 
description 341 
DISK option 342 
error handling for 351 
INC option 342 
input files 346 
multilevel updates, example with 
auxiliary control file 348 
NOCTL option 342 
NOINC option 342 
NOREP option 341 
NOSEQ8 option 341 
NOSTK option 342 
NOTERM option 342 
output files JI46E 
PRINT option 342 
REP option 341 
SEQ8 option 341 
STK option 342,350 
STOR option 342 
TERM option 342 
Warnings by 351 
control statements 
comments 346 
DELETE 345 
INSERT 344 
REPLACE 345 
SFQUENCE 343 
filetype, default CMS editor settings 
519 
option, of XEDIT command 354 
option of TAPPDS command 332 
update log 
for UPDATE command oferations 342 
generating at your terginal 242 
UPDIRT option of RENAME command 283 
uppercase letters 
ccnverting to lowercase, with CCFYFILE 
command 43 
Suppressing translaticn cf lcwercase 
letters with CMS editor 269 
UPSI 
byte 
querying setting cf 2Z€2 
setting 302 
option 
of CMS QUERY command 262 
of CMS SET command 302 
UPTDxxxx filetype, default CMS editor 
Settings 519 
user catalog 
identifying 85 


in CMS/DOS’ 89 

user file directory 21 

contents of 21 

creating 21 

updating on disk 281 
user-defined synonyms, displaying 258 
user-written commands 

assigning synonyms for 318 

creating 150 


Vv 
variakle data 
in EXEC procedure 
displaying A442 
Funching 437 
stacking 440 
variakle symbols 
asSigning values to in EXEC frocedures 
425 
reading from terminal or ccnsole stack, 
in EXEC procedure 438 
Substituting, in EXEC procedure 438 
testing, in EXEC procedure 435 
variable-length files 
converting to fixed-length 47 
using RECFM subcommand 387 
reading and writing with CMS macros 472 
VARS operand of GREAD control statenent 
438 
verification setting, for CMS editor, 
changing 402 
VERIFY subcommand, description 402 
virtual disks (see also disks) 
counting cylinders on 145 
initializing 144 
resetting number of cylinders on 145 
valid addresses for 20 
virtual machines 
copfonents of 1 
console 1 
definition 1 
environment, determining status of 254 
VM/SP, kasic description 1 
VOLID operand 
Of FILEDEF command 130 
Of LAEFLDEF command 174 
VOLSEQ operand, of LABELDEF command 174 
VSAM 
catalogs 
determining which catalog is searched 
82 
identifying 85 
identifying in CMS/DOS_ 81 
data set extents, displaying 79 
determining free space extents 177 
files 
defining with DLBL conmand 74 
specifying disk extents 83 
Specifying disk extents in CMS/DOS 
79 
Master catalog 
identifying 8&5 
identifying in CMS/DOS 81 
opticn 
of DLEL command 75 
of SET DOS ON command 302 
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VSBASIC 


restrictions 
for OS/VS users 521 
for VSE users 521 
files, renumbering 388 


filetype, default CMS editor settings 
519 


VSBDATA filetype, default CMS editor 


settings 


W 


519 


wait, for terminal I/O to complete, WAITT 
Macro 500 
WAITD macro 
description 499 
ERROR operand 499 
used with HNDINT macro 475 
WAITRE CMS function 
description 456 
logical line editing with 457 
using 457 
WAITRD function, reading lines fron 
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